Ottenere i pacchetti in anteprima per un'appGet package flights for an app

Usare questo metodo nell'API di invio Microsoft Store per elencare i voli del pacchetto per un'app registrata per l'account del centro per i partner.Use this method in the Microsoft Store submission API to list the package flights for an app that is registered to your Partner Center account. Per altre informazioni sui pacchetti in anteprima, vedi Pacchetti in anteprima.For more information about package flights, see Package flights.

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}/listflights

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 ObbligatorioRequired
applicationIdapplicationId stringstring ID dello Store dell'app per cui vuoi recuperare i pacchetti in anteprima.The Store ID of the app for which you want to retrieve the package flights. Per altre informazioni sull'ID dello Store, vedi Visualizzare i dettagli dell'identità dell'app.For more information about the Store ID, see View app identity details. Yes
toptop INTint Numero di elementi da restituire nella richiesta (in altre parole, numero di pacchetti in anteprima da restituire).The number of items to return in the request (that is, the number of package flights to return). Se il tuo account ha più pacchetti in anteprima rispetto al valore specificato nella query, il contenuto della risposta include un percorso URI relativo che puoi aggiungere al metodo URI per richiedere la successiva pagina di dati.If your account has more package flights than the value you specify in the query, the response body includes a relative URI path that you can append to the method URI to request the next page of data. NoNo
skipskip INTint Numero di elementi da ignorare nella query prima di restituire gli elementi rimanenti.The number of items to bypass in the query before returning the remaining items. Usa questo parametro per scorrere i set di dati.Use this parameter to page through data sets. Ad esempio, top=10 e skip=0 recupera gli elementi da 1 a 10, top=10 e skip=10 recupera gli elementi da 11 a 20 e così via.For example, top=10 and skip=0 retrieves items 1 through 10, top=10 and skip=10 retrieves items 11 through 20, and so on. NoNo

Corpo della richiestaRequest body

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

Esempi di richiestaRequest examples

L'esempio seguente illustra come elencare i pacchetti in anteprima per un'app.The following example demonstrates how to list all the package flights for an app.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

L'esempio seguente illustra come elencare il primo pacchetto in anteprima per un'app.The following example demonstrates how to list the first package flight for an app.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

RispostaResponse

L'esempio seguente mostra il contenuto della risposta JSON restituito da una richiesta riuscita relativa al primo pacchetto in anteprima per un'app con un totale di 3 pacchetti in anteprima.The following example demonstrates the JSON response body returned by a successful request for the first package flight for an app with three total package flights. Per altri dettagli sui valori nel contenuto della risposta, vedi la sezione seguente.For more details about the values in the response body, see the following section.

{
  "value": [
    {
      "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"
    }
  ],
  "totalCount": 3
}

Corpo della rispostaResponse body

ValoreValue TipoType DescrizioneDescription
@nextLink stringstring In presenza di altre pagine di dati, questa stringa contiene un percorso relativo che puoi aggiungere all'URI della richiesta di base https://manage.devcenter.microsoft.com/v1.0/my/per richiedere la pagina successiva dei dati.If there are additional pages of data, this string contains a relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to request the next page of data. Se, ad esempio, il parametro Top del corpo della richiesta iniziale è impostato su 2, ma sono presenti 4 voli di pacchetto per l'app, il corpo della risposta includerà il @nextLink valore applications/{applicationid}/listflights/?skip=2&top=2 , che indica che è possibile chiamare https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 per richiedere i 2 voli di pacchetto successivi.For example, if the top parameter of the initial request body is set to 2 but there are 4 package flights for the app, the response body will include a @nextLink value of applications/{applicationid}/listflights/?skip=2&top=2, which indicates that you can call https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 to request the next 2 package flights.
valuevalue arrayarray Matrice di oggetti che forniscono informazioni sui pacchetti in anteprima per l'app specificata.An array of objects that provide information about package flights for the specified app. Per altre informazioni sui dati in ogni oggetto, vedi la risorsa pacchetto in anteprima.For more information about the data in each object, see Flight resource.
totalCounttotalCount INTint Numero totale di righe nel risultato di dati per la query, ovvero il numero totale di pacchetti in anteprima per l'app specificata.The total number of rows in the data result for the query (that is, the total number of package flights for the specified app).

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
404404 Non è stato trovato alcun pacchetto in anteprima.No package flights were 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.