Condividi tramite

Prenota un volo di pacchetto

Usa questo metodo nell'API di invio del Microsoft Store per ottenere dati per un volo di un pacchetto per un'app registrata nel tuo account Partner Center.

Prerequisiti

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

  • Se non l'hai già fatto, completa tutti i prerequisiti per l'API di invio al 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, si hanno 60 minuti per usarlo prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

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

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

Header di richiesta

Intestazione TIPO Descrizione
Autorizzazione corda Obbligatorio. Il token di accesso di Azure AD nel formato Bearer<token>.

Parametri della richiesta

Nome TIPO Descrizione
ID dell'applicazione corda Obbligatorio. ID dello Store dell'app che contiene il package flight che desideri consultare. L'ID dello Store per l'app è disponibile nel Centro per i partner.
flightId corda Obbligatorio. ID del volo del pacchetto da recuperare. Questo ID è disponibile nei dati di risposta per le richieste di creare un volo di pacchetti e ottenere voli di pacchetti per un'app. Per un volo creato nel Partner Center, questo ID è disponibile anche nell'URL della pagina del volo nel Partner Center.

Testo della richiesta

Non bisogna fornire il corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente dimostra come recuperare informazioni su un pacchetto di volo con l'ID 43e448df-97c9-4a43-a0bc-2a445e736bcd per un'app con l'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>

Risposta

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per altri 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 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 Oggetto che fornisce informazioni sull'ultima sottomissione pubblicata per il volo del pacchetto. Per altre informazioni, vedere la sezione Oggetto invio di seguito.
invioVolopendente oggetto Un oggetto che fornisce informazioni sulla sottomissione attualmente in sospeso per il volo del pacchetto. Per altre informazioni, vedere la sezione Oggetto invio di seguito.
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.

Oggetto di sottomissione

I valori lastPublishedFlightSubmission e pendingFlightSubmission nel corpo della risposta contengono oggetti che forniscono informazioni sulle risorse riguardanti un invio per il pacchetto di volo. Questi oggetti hanno 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.

Codici di errore

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

Codice di errore Descrizione
400 La richiesta non è valida.
404 Impossibile trovare il volo del pacchetto specificato.
409 L'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.
  • Last updated on