Condividi tramite

Ottenere i dati dell'app

  • Articolo

Usare i metodi seguenti nell'API di l'invio di Microsoft Store per ottenere i dati per le app esistenti nel proprio account del Centro per i partner. Per un'introduzione all'API di l'invio di Microsoft Store, inclusi i prerequisiti per l'uso dell'API, vedere Creare e gestire gli invii usando i servizi di Microsoft Store.

Per poter usare questi metodi, è necessario che l'app sia già presente nel proprio account del Centro per i partner. Per creare o gestire gli invii per le app, vedere i metodi in Gestire gli invii di app.

Method URI Descrizione
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Ottenere dati per tutte le app
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Ottenere dati per un'app specifica
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Ottenere i componenti aggiuntivi per un'app
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Ottenere i pacchetti in anteprima per un'app

Prerequisiti

Se non lo hai già fatto, completa tutti iprerequisitio l'API di invio a Microsoft Store prima di provare a utilizzare uno di questi metodi.

Risorse dati

I metodi dell'API di invio di Microsoft Store per ottenere i dati delle app usano le risorse di dati JSON seguenti.

Risorsa dell'applicazione

Questa risorsa rappresenta un'app registrata nel proprio account.

{
  "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
}

Questa risorsa presenta i valori seguenti.

Valore Tipo Descrizione
id string ID dello Store dell'app. Per ulteriori informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
primaryName string Nome primario dell'app.
packageFamilyName string Nome della famiglia di pacchetti dell'app.
packageIdentityName string Nome dell'identità del pacchetto dell'app.
publisherName string ID dell'editore Windows associato all'app. Corrisponde al valore Pacchetto/Identità/Editore visualizzato per l'app nella pagina Identità app del Centro per i partner.
firstPublishedDate string Data di pubblicazione dell'app, in formato ISO 8601.
lastPublishedApplicationSubmission oggetto Risorsa di invio che fornisce informazioni sull'ultimo invio pubblicato per l'app.
pendingApplicationSubmission oggetto Risorsa di invio che fornisce informazioni sull'invio in sospeso corrente per l'app.
hasAdvancedListingPermission boolean Indica se è possibile configurare gamingOptions o trailers per gli invii per l'app. Questo valore è true per gli invii creati dopo maggio 2017.

Risorsa componente aggiuntivo

Questa risorsa fornisce informazioni su un componente aggiuntivo.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Questa risorsa presenta i valori seguenti.

Valore Tipo Descrizione
inAppProductId string L'ID dello Store del componente aggiuntivo. Questo valore viene fornito dallo Store. Un esempio di ID dello Store è 9NBLGGH4TNMP.

Risorsa pacchetto in anteprima

Questa risorsa fornisce informazioni su un pacchetto in anteprima per un'app.

{
    "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"
}

Questa risorsa presenta i valori seguenti.

Valore Tipo Descrizione
flightId string ID del pacchetto in anteprima. Questo valore è fornito dal Centro per i partner.
friendlyName string Nome del pacchetto in anteprima, come specificato dallo sviluppatore.
lastPublishedFlightSubmission oggetto Risorsa di invio che fornisce informazioni sull'ultimo invio pubblicato per il pacchetto in anteprima.
pendingFlightSubmission oggetto Risorsa di invio che fornisce informazioni sull'invio in sospeso corrente per il pacchetto in anteprima.
groupIds array Matrice di stringhe che contengono gli ID dei gruppi di pacchetti in anteprima associati al pacchetto in anteprima. Per ulteriori informazioni sui gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima.
rankHigherThan string Nome descrittivo del pacchetto in anteprima con classificazione immediatamente inferiore al pacchetto in anteprima corrente. Per ulteriori informazioni sulla classificazione dei gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima.

Risorsa invio

Questa risorsa fornisce informazioni su un invio. Nell'esempio seguente viene illustrato il formato di questa risorsa.

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

Questa risorsa ha i seguenti valori.

Valore Tipo Descrizione
id string L'ID dell'invio.
resourceLocation string Un percorso relativo che puoi aggiungere https://manage.devcenter.microsoft.com/v1.0/my/ all'URI della richiesta di base per recuperare i dati completi per l'invio.