Condividi tramite

Ottieni un pacchetto di distribuzione

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per ottenere dati per un pacchetto in anteprima per un'app registrata nel proprio account del Centro per i partner.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si ha ancora fatto, completare i prerequisiti per l'API di invio di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiedi

Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del corpo della richiesta.

metodo URI della richiesta
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Nome Tipo Descrizione
applicationId string Obbligatorio. ID dello Store dell'app che contiene il pacchetto in anteprima che si desidera ottenere. L'ID dello Store per l'app è disponibile nel Centro per i partner.
flightId string Obbligatorio. ID del pacchetto in anteprima da ottenere. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un pacchetto in anteprima e recupero dei pacchetti in anteprima per un'app. Per un pacchetto in anteprima creato nel Centro per i partner, questo ID è anche disponibile nell'URL della pagina di anteprima nel Centro per i partner.

Corpo della richiesta

Non fornire un corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come recuperare informazioni su un pacchetto in anteprima con ID 43e448df-97c9-4a43-a0bc-2a445e736bcd per un'app il cui valore di ID dello Store è 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

Response

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per ulteriori dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Corpo della risposta

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 Oggetto che fornisce informazioni sull'ultimo invio pubblicato per il pacchetto in anteprima. Per altre informazioni, vedere la Oggetto invio seguente.
pendingFlightSubmission oggetto Oggetto che fornisce informazioni sull'invio in sospeso corrente per il pacchetto in anteprima. Per altre informazioni, vedere la Oggetto invio seguente.
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.

Oggetto invio

I valori lastPublishedFlightSubmission e pendingFlightSubmission nel corpo della risposta contengono oggetti che forniscono informazioni sulle risorse relative a un invio per il pacchetto in anteprima. Gli oggetti hanno i valori seguenti.

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

Codici di errore

Se la richiesta non può essere completata, la risposta conterrà uno dei codici di errore HTTP seguenti.

Codice errore Description
400 La richiesta non è valida.
404 Il pacchetto in anteprima specificato non è stato trovato.
409 L'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio di Microsoft Store.