Compartir a través de

Obtención de datos de la aplicación

  • Artículo

Usa los métodos siguientes en la API de envío de Microsoft Store para obtener datos de las aplicaciones existentes en tu cuenta del Centro de partners. 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.

Para poder usar estos métodos, la aplicación ya debe existir en la cuenta del Centro de partners. Para crear o administrar envíos para aplicaciones, consulte los métodos de Administración de envíos de aplicaciones.

Método URI Descripción
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Obtención de datos para todas las aplicaciones
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obtención de datos para una aplicación específica
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Obtener complementos para una aplicación
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obtener paquetes piloto para una aplicación

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 obtener datos de la aplicación usan los siguientes recursos de datos JSON.

Recurso de aplicación

Este recurso representa una aplicación registrada en su cuenta.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
id string 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.
primaryName string Nombre principal de la aplicación.
packageFamilyName string Nombre de familia del paquete de la aplicación.
packageIdentityName string Nombre de identidad del paquete de la aplicación.
publisherName string Identificador del publicador de Windows asociado a la aplicación. Esto corresponde al valor Package/Identity/Publisher que aparece en la página Identidad de la aplicación para la aplicación en el Centro de partners.
firstPublishedDate string La fecha en que la aplicación se publicó por primera vez, en formato ISO 8601.
lastPublishedApplicationSubmission objeto Un recurso de envío que proporciona información sobre el último envío publicado para la aplicación.
pendingApplicationSubmission objeto Recurso de envío que proporciona información sobre el envío pendiente actual de la aplicación.
hasAdvancedListingPermission boolean Indica si puedes configurar gamingOptions o trailers para envíos para la aplicación. Este valor es true para los envíos creados después de mayo de 2017.

Recurso de complemento

Este recurso proporciona información sobre un complemento.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
inAppProductId string Id. de la Tienda del complemento. El Almacén proporciona este valor. Un id. de tienda de ejemplo es 9NBLGGH4TNMP.

Recurso piloto

Este recurso proporciona información sobre un paquete piloto para una aplicación.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Este recurso tiene los siguientes valores.

Valor Tipo Descripción
flightId string Identificador del paquete piloto. Este valor lo proporciona el Centro de partners.
friendlyName string Nombre del paquete piloto, según lo especificado por el desarrollador.
lastPublishedFlightSubmission objeto Recurso de envío que proporciona información sobre el último envío publicado para el paquete piloto.
pendingFlightSubmission objeto Un recurso de envío que proporciona información sobre el envío pendiente actual para el paquete piloto.
groupIds array Matriz de cadenas que contienen los identificadores de los grupos piloto asociados al paquete piloto. Para obtener más información sobre los grupos piloto, consulta Paquetes piloto.
rankHigherThan string Nombre descriptivo del paquete piloto que se clasifica inmediatamente más bajo que el paquete piloto actual. Para obtener más información sobre la clasificación de grupos piloto, consulta Paquetes piloto.

Recurso de envío

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

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

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.