Condividi tramite

Ottenere i dati dell'app

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

Prima di poter usare questi metodi, l'app deve esistere già nell'account del Centro per i partner. Per creare o gestire gli invii per le app, vedi i metodi in Gestire gli invii di app.

Metodo URI (Identificatore Uniforme delle Risorse) Descrizione
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/applications Ottenere dati per tutte le app
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Ottenere dati per un'app specifica
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Ottenere componenti aggiuntivi per un'app
OTTIENI https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Ottenere pacchetti di voli per un'app

Prerequisiti

Se non è già stato fatto, completare tutti i prerequisiti e per l'API di invio a Microsoft Store prima di provare a usare uno di questi metodi.

Risorse dati

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

Risorsa di applicazione

Questa risorsa rappresenta un'app registrata nell'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 ha i valori seguenti.

Valore TIPO Descrizione
Id corda ID dello Store dell'app. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
nomePrincipale corda Nome principale dell'app.
nomeFamigliaPacchetto corda Nome della famiglia di pacchetti dell'app.
nomeidentitàpacchetto corda Nome dell'identità del pacchetto dell'app.
Nome editore corda ID editore di Windows associato all'app. Il valore di Package/Identity/Publisher corrisponde a quello che appare nella pagina Identità dell'app per l'app nel Centro partner.
dataPrimaPubblicazione corda Data di pubblicazione dell'app, in formato ISO 8601.
ultimaSottomissioneApplicazionePubblicata oggetto Una risorsa di invio che fornisce informazioni sull'ultimo invio pubblicato per l'app.
sottomissioneDomandaInSospeso oggetto Una risorsa di sottomissione che fornisce informazioni sull'attuale sottomissione in sospeso per l'app.
haAutorizzazioneElencoAvanzato booleano Indica se è possibile configurare le gamingOptions o i trailer nelle invii dell'app. Questo valore è vero per gli invii creati dopo maggio 2017.

Risorsa aggiuntiva

Questa risorsa fornisce informazioni su un componente aggiuntivo.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Questa risorsa ha i valori seguenti.

Valore TIPO Descrizione
inAppProductId (identificativo del prodotto in-app) corda ID dello Store del componente aggiuntivo. Questo valore viene fornito dallo Store. Un esempio di ID dello Store è 9NBLGGH4TNMP.

Risorsa di volo

Questa risorsa fornisce informazioni su un pacchetto di volo 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 ha i valori seguenti.

Valore TIPO Descrizione
flightId corda ID per il volo del pacchetto. Questo valore viene fornito dal Centro per i partner.
nome amichevole corda Nome del pacchetto di volo, come specificato dallo sviluppatore.
ultimaPubblicazioneDellaSottomissioneDelVolo oggetto Una risorsa di sottomissione che fornisce informazioni sull'ultima sottomissione pubblicata per il test del pacchetto.
invioVolopendente oggetto Una risorsa di sottomissione che fornisce informazioni sulla sottomissione attuale in attesa per il pacchetto di distribuzione.
ID di gruppo elenco Una matrice di stringhe che contiene gli ID dei gruppi di volo associati al volo del pacchetto. Per ulteriori informazioni sui gruppi di voli, consulta Pacchetti di voli.
rankHigherThan corda Nome amichevole del volo del pacchetto classificato immediatamente inferiore al volo del pacchetto corrente. Per ulteriori informazioni sulla classificazione dei gruppi di volo, vedi Pacchetti di volo.

Risorsa di presentazione

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

Valore TIPO Descrizione
Id corda ID dell'invio.
posizione della risorsa corda Un percorso relativo da aggiungere all'URI della richiesta https://manage.devcenter.microsoft.com/v1.0/my/ di base per recuperare i dati completi della presentazione.

 

  • Last updated on