Compartir a través de

Administración de complementos

  • Artículo

Usa los métodos siguientes en la API de envío de Microsoft Store para administrar complementos para tus aplicaciones. Para obtener una introducción a la API de envío de Microsoft Store, incluidos los requisitos previos para usar la API, consulte Crear y administrar envíos mediante los servicios de Microsoft Store.

Estos métodos solo se pueden usar para obtener, crear o eliminar complementos. Para crear envíos para complementos, consulte los métodos de Administración de envíos de complementos.

Método URI Descripción
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Obtener todos los complementos para las aplicaciones
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Obtener un complemento específico
PUBLICAR https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Crear un complemento
Delete https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Eliminar un complemento

Requisitos previos

Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store antes de intentar usar cualquiera de estos métodos.

Recursos de datos

Los métodos de la API de envío de Microsoft Store para administrar complementos usan los siguientes recursos de datos JSON.

Recurso de complemento

Este recurso describe un complemento.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "TestAddOn",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
applications array Matriz que contiene un recurso de aplicación que representa la aplicación a la que está asociado este complemento. Solo se admite un elemento en esta matriz.
id string Id. de la Tienda del complemento. El Almacén proporciona este valor. Un id. de tienda de ejemplo es 9NBLGGH4TNMP.
productId string Identificador de producto del complemento. Este es el identificador proporcionado por el desarrollador cuando se creó el complemento. Para obtener más información, consulte Establecer el tipo de producto y el identificador de producto.
productType string Tipo de producto del complemento. Se admiten los siguientes valores: Durable y Consumable.
lastPublishedInAppProductSubmission objeto Recurso de envío que proporciona información sobre el último envío publicado para el complemento.
pendingInAppProductSubmission objeto Recurso de envío que proporciona información sobre el envío pendiente actual para el complemento.

Recurso de aplicación

Este recurso descrimina la aplicación a la que está asociado un complemento. En el ejemplo siguiente se muestra el formato de este recurso.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
value objeto Objeto que contiene los siguientes valores:
  • id. El identificador de la Tienda de la aplicación. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación.
  • resourceLocation. Ruta de acceso relativa que puede anexar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos de la aplicación.
totalCount int Número de objetos de aplicación en la matriz de aplicaciones del cuerpo de la respuesta.

Recurso de envío

Este recurso proporciona información sobre un envío para un complemento. En el ejemplo siguiente se muestra el formato de este recurso.

{
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
id string El identificador del envío.
resourceLocation string Ruta de acceso relativa que puede anexar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos del envío.