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, consulta 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 de aplicaciones, consulta los métodos de Administrar envíos de aplicaciones.

Método Identificador URI Descripción
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Obtener datos para todas las aplicaciones
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obtener 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 tu 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 Id. de la Tienda de la aplicación. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones.
primaryName cadena Nombre principal de la aplicación.
packageFamilyName cadena El nombre de familia de paquete de la aplicación.
packageIdentityName cadena El nombre de identidad de paquete de la aplicación.
publisherName string El identificador del editor de Windows asociado con la aplicación. Esto corresponde al valor Package/Identity/Publisher que aparece en la página Identidad de la aplicación de la aplicación en el Centro de partners.
firstPublishedDate cadena La fecha en que se publicó la aplicación por primera vez, en formato ISO 8601.
lastPublishedApplicationSubmission object Un recurso de envío que proporciona información sobre el último envío publicado para la aplicación.
pendingApplicationSubmission object Un recurso de envío que proporciona información sobre el envío pendiente actual para 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 cadena Id. de la Tienda del complemento. Este valor lo proporciona la Tienda. Un ejemplo de Id. de la Tienda sería 9NBLGGH4TNMP.

Recursos de paquete 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 cadena El identificador del paquete piloto. Este valor lo proporciona el Centro de partners.
friendlyName string El nombre del paquete piloto, según lo especifica el desarrollador.
lastPublishedFlightSubmission object Un recurso de envío que proporciona información sobre el último envío publicado para el paquete piloto.
pendingFlightSubmission object Un recurso de envío que proporciona información sobre el envío pendiente actual para el paquete piloto.
groupIds array Una matriz de cadenas que contienen los identificadores de los grupos de pilotos asociados con el paquete piloto. Para obtener más información sobre los grupos de pilotos, consulta Paquetes piloto.
rankHigherThan cadena El nombre descriptivo del paquete piloto que está clasificado inmediatamente por debajo del paquete piloto actual. Para obtener más información sobre la clasificación de grupos de pilotos, consulta Paquetes piloto.

Recurso de envío

Este recurso proporciona información acerca de un envío. En el siguiente ejemplo 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 Identificador del envío.
resourceLocation cadena Ruta de acceso relativa que se puede anexar al URI de la solicitud de base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar los datos completos para el envío.