Compartir a través de

Obtención de datos de la aplicación

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

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

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

Importancia Tipo Descripción
identificación cuerda / cadena 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.
nombre principal cuerda / cadena Nombre principal de la aplicación.
nombreDeFamiliaDelPaquete cuerda / cadena Nombre de familia del paquete de la aplicación.
nombreDeIdentidadDePaquete cuerda / cadena Nombre de identidad del paquete de la aplicación.
nombre del editor cuerda / cadena Identificador del publicador de Windows asociado a la aplicación. Esto corresponde al valor de Package/Identity/Publisher que aparece en la página App identity de la aplicación en el Centro de partners.
fechaPrimeraPublicación cuerda / cadena La fecha en que la aplicación se publicó por primera vez, en formato ISO 8601.
últimaPresentaciónDeSolicitudPublicada objeto Un recurso de envío que proporciona información sobre el último envío publicado para la aplicación.
presentaciónDeSolicitudPendiente objeto Un recurso de presentación que proporciona información sobre la presentación pendiente actual de la app.
tienePermisoAvanzadoDeListado booleano Indica si puedes configurar los gamingOptions o los trailers para los envíos de la aplicación. Este valor es verdadero para las presentaciones creadas después de mayo de 2017.

Recurso complementario

Este recurso proporciona información sobre un complemento.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Este recurso tiene los siguientes valores.

Importancia Tipo Descripción
inAppProductId (ID de producto en la aplicación) cuerda / cadena ID de la tienda del complemento. La tienda proporciona este valor. Un ID de tienda de ejemplo es 9NBLGGH4TNMP.

Recurso de vuelo

Este recurso proporciona información sobre un paquete de vuelo 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.

Importancia Tipo Descripción
flightId cuerda / cadena Identificador del paquete de vuelo. Este valor lo proporciona Partner Center.
nombre amistoso cuerda / cadena Nombre del paquete de vuelo, según lo especificado por el desarrollador.
Última Presentación de Vuelo Publicada objeto Un recurso de envío que proporciona información sobre el último envío publicado para el vuelo del paquete.
pendienteDeEnvioDeVuelo objeto Un recurso de envío que proporciona información sobre el envío pendiente actual para el vuelo del paquete.
identificadores de grupo matriz Matriz de cadenas que contienen los identificadores de los grupos de vuelo asociados al vuelo de paquete. Para obtener más información sobre los grupos de vuelos, consulta Paquete de vuelos.
rangoMásAltoQue cuerda / cadena El nombre amigable del paquete de vuelos que se clasifica inmediatamente más bajo que el paquete de vuelos actual. Para obtener más información sobre la clasificación de grupos de vuelos, consulte Paquete de vuelos.

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

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.