Compartir a través de

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 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 envíos. Para crear un envío para un complemento, consulte los métodos de 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.
  • Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitar

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 URI de solicitud
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Encabezado de solicitud

Encabezado Tipo Descripción
Autorización 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 parámetros siguientes.

Parámetro Tipo Descripción Obligatorio
applicationIds array 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í
productId string 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í
productType string 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 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 Description
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.