Compartir a través de

Creación de un complemento

Usa este método en la API de envío de Microsoft Store para crear un complemento (también conocido como producto desde la aplicación o IAP) para una aplicación registrada en tu cuenta del Centro de partners.

Nota:

Este método crea un complemento sin presentaciones. Para crear una presentación para un complemento, consulte los métodos en Administrar presentaciones de complementos.

Prerrequisitos

Para usar este método, primero debe hacer lo siguiente:

  • Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
  • Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitud

Este método tiene la sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones del encabezado y el cuerpo de la solicitud.

Método Solicitud de URI
PUBLICACIÓN https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Cabecera de solicitud

Cabecera Tipo Descripción
Autorización cuerda / cadena Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Cuerpo de la solicitud

El cuerpo de la solicitud tiene los parámetros siguientes.

Parámetro Tipo Descripción Obligatorio
identificadoresDeAplicación arreglo Matriz que contiene el identificador de la Tienda de la aplicación con la que está asociado este complemento. Solo se admite un elemento en esta matriz. Sí
ID de producto cuerda / cadena Identificador de producto del complemento. Se trata de un identificador que puede usar en el código para hacer referencia al complemento. Para obtener más información, consulte Establecer el tipo de producto y el identificador de producto. Sí
tipoDeProducto cuerda / cadena Tipo de producto del complemento. Se admiten los siguientes valores: Durable y Consumable. Sí

Ejemplo de solicitud

En el ejemplo siguiente se muestra cómo crear un complemento consumible para una aplicación.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

Respuesta

En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores en el cuerpo de la respuesta, consulte el recurso complementario .

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Descripción
400 La solicitud no es válida.
409 No se pudo crear el complemento debido a su estado actual o el complemento usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store.