Compartir a través de

Administrar complementos

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, consulta 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 propuestas para complementos, consulte los métodos de Administrar presentaciones de complementos.

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

Prerrequisitos

Si aún no lo ha hecho, complete todos los requisitos previos de para la API de envío de Microsoft Store antes de intentar utilizar 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 complementario

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.

Importancia Tipo Descripción
aplicaciones arreglo 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.
identificación cuerda / cadena ID de la tienda del complemento. La tienda proporciona este valor. Un ID de tienda de ejemplo es 9NBLGGH4TNMP.
ID de producto cuerda / cadena 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.
tipoDeProducto cuerda / cadena Tipo de producto del complemento. Se admiten los siguientes valores: Durable y Consumable.
últimaPublicaciónEnEnvíoDeProductoEnApp objeto Un recurso de envío que proporciona información sobre el último envío publicado para el complemento.
pendienteDeEnvíoDeProductoEnApp objeto Un recurso de envío que proporciona información sobre el envío pendiente actual para el complemento.

Recurso de aplicación

Este recurso describe la aplicación a la que está asociada una extensión. 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.

Importancia Tipo Descripción
valor objeto Objeto que contiene los siguientes valores:
  • ID. El ID 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 de https://manage.devcenter.microsoft.com/v1.0/my/ base para recuperar los datos completos de la aplicación.
conteo total Int Cantidad de objetos de la aplicación en la matriz de aplicaciones del cuerpo de la respuesta.

Recurso para 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.

Importancia Tipo Descripción
identificación cuerda / cadena El identificador del envío.
ubicación del recurso cuerda / cadena Ruta de acceso relativa que puede adjuntar al URI de solicitud base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos de la presentación.