Ottiene un pacchetto in anteprima.Get a package flight

Usare questo metodo nell'API di invio Microsoft Store per ottenere i dati per un volo del pacchetto per un'app registrata nell'account del centro per i partner.Use this method in the Microsoft Store submission API to get data for a package flight for an app that is registered to your Partner Center account.

PrerequisitiPrerequisites

Per usare questo metodo, devi prima eseguire le operazioni seguenti:To use this method, you need to first do the following:

  • Se non è già stato fatto, completare tutti i prerequisiti per l'API di invio Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Ottieni un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo.Obtain an Azure AD access token to use in the request header for this method. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza.After you obtain an access token, you have 60 minutes to use it before it expires. Dopo la scadenza del token, puoi ottenerne uno nuovo.After the token expires, you can obtain a new one.

RichiestaRequest

La sintassi di questo metodo è la seguente.This method has the following syntax. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.See the following sections for usage examples and descriptions of the header and request body.

MetodoMethod URI richiestaRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AutorizzazioneAuthorization stringstring Obbligatorio.Required. Il token di accesso Azure ad nel token di connessione del modulo < token > .The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

NomeName TipoType DescrizioneDescription
applicationIdapplicationId stringstring Obbligatorio.Required. ID dello Store dell'app che contiene il pacchetto in anteprima da ottenere.The Store ID of the app that contains the package flight you want to get. L'ID dello Store per l'app è disponibile nel centro per i partner.The Store ID for the app is available in Partner Center.
flightIdflightId stringstring Obbligatorio.Required. ID del pacchetto in anteprima da ottenere.The ID of the package flight to get. Questo ID è disponibile nei dati della risposta per le richieste per creare un pacchetto Flight e ottenere i voli dei pacchetti per un'app.This ID is available in the response data for requests to create a package flight and get package flights for an app. Per un volo creato in Partner Center, questo ID è disponibile anche nell'URL della pagina di volo nel centro per i partner.For a flight that was created in Partner Center, this ID is also available in the URL for the flight page in Partner Center.

Corpo della richiestaRequest body

Non includere il contenuto della richiesta per questo metodo.Do not provide a request body for this method.

Esempio di richiestaRequest example

L'esempio seguente dimostra come recuperare le informazioni su un pacchetto in anteprima con l'ID 43e448df-97c9-4a43-a0bc-2a445e736bcd per un'app il cui valore di ID dello Store è 9WZDNCRD91MD.The following example demonstrates how to retrieve information about a package flight with the ID 43e448df-97c9-4a43-a0bc-2a445e736bcd for an app with the Store ID value 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>

RispostaResponse

L'esempio seguente illustra il contenuto della risposta JSON per una chiamata a questo metodo.The following example demonstrates the JSON response body for a successful call to this method. Per altri dettagli sui valori nel contenuto della risposta, vedi le sezioni seguenti.For more details about the values in the response body, see the following sections.

{
  "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 rispostaResponse body

ValoreValue TipoType DescrizioneDescription
flightIdflightId stringstring ID del pacchetto in anteprima.The ID for the package flight. Questo valore viene fornito dal centro per i partner.This value is supplied by Partner Center.
friendlyNamefriendlyName stringstring Nome del pacchetto in anteprima, specificato dallo sviluppatore.The name of the package flight, as specified by the developer.
lastPublishedFlightSubmissionlastPublishedFlightSubmission objectobject Oggetto che fornisce informazioni sull'ultimo invio pubblicato per il pacchetto in anteprima.An object that provides information about the last published submission for the package flight. Per altre informazioni, vedi la sezione Oggetto Submission più avanti.For more information, see the Submission object section below.
pendingFlightSubmissionpendingFlightSubmission objectobject Oggetto che fornisce informazioni sull'invio in sospeso corrente per il pacchetto in anteprima.An object that provides information about the current pending submission for the package flight. Per altre informazioni, vedi la sezione Oggetto Submission più avanti.For more information, see the Submission object section below.
groupIdsgroupIds arrayarray Matrice di stringhe che contiene gli ID dei gruppi di versioni di anteprima associati al pacchetto in anteprima.An array of strings that contain the IDs of the flight groups that are associated with the package flight. Per altre informazioni sui gruppi di versioni di anteprima, vedi Pacchetti in anteprima.For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan stringstring Nome descrittivo del pacchetto in anteprima con il rango immediatamente inferiore a quello del pacchetto in anteprima corrente.The friendly name of the package flight that is ranked immediately lower than the current package flight. Per altre informazioni sul rango dei gruppi di versioni di anteprima, vedi Pacchetti in anteprima.For more information about ranking flight groups, see Package flights.

Oggetto invioSubmission object

I valori lastPublishedFlightSubmission e pendingFlightSubmission nel contenuto della risposta includono oggetti che forniscono informazioni sulla risorse relative a un invio per un pacchetto in anteprima.The lastPublishedFlightSubmission and pendingFlightSubmission values in the response body contain objects that provide resource information about a submission for the package flight. Questi oggetti hanno i valori seguenti.These objects have the following values.

ValoreValue TipoType DescrizioneDescription
idid stringstring ID dell'invio.The ID of the submission.
resourceLocationresourceLocation stringstring Percorso relativo che puoi aggiungere all'URI della richiesta di base https://manage.devcenter.microsoft.com/v1.0/my/ per recuperare i dati completi per l'invio.A relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to retrieve the complete data for the submission.

Codici di erroreError codes

Se la richiesta non può essere completata, la risposta conterrà uno dei seguenti codici di errore HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Codice di erroreError code DescrizioneDescription
400400 La richiesta non è valida.The request is invalid.
404404 Non è possibile trovare il pacchetto in anteprima specificato.The specified package flight could not be found.
409409 L'app usa una funzionalità del centro per i partner che non è attualmente supportata dall'API di invio Microsoft Store.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.