Crear un complemento

  • Artículo

Usa este método en la API de envío de Microsoft Store para crear un complemento (también conocido como producto en 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 envíos. Para crear un envío de un complemento, consulta los métodos en Administración de envíos de complementos.

Requisitos previos

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

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

Solicitud

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

Método URI de solicitud
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Encabezado de solicitud

Encabezado Tipo Descripción
Authorization string Necesario. Token de acceso de Azure AD con el formato Token de portador<>.

Cuerpo de la solicitud

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

Parámetro Tipo Descripción Obligatorio
applicationIds array Una matriz que contiene la Id. de la tienda de la aplicación asociada con este complemento. Solo se admite un elemento en esta matriz. Sí
productId string Id. del producto del complemento. Esto es un identificador que puede usarse en el código para hacer referencia al complemento. Para obtener más información, consulta Establecer el tipo de producto y el id. del producto. Yes
productType cadena Tipo de producto del complemento. Se admiten los siguientes valores: Duradero y Consumible. Sí

Ejemplo de solicitud

El siguiente ejemplo muestra cómo crear un nuevo complemento de 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",
}

Response

En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método. Para obtener más información acerca de los valores en el cuerpo de la respuesta, consulta Recurso de complemento.

{
  "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.