Recuperare informazioni sull'implementazione per un invio dell'app

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per ottenere informazioni sull'implementazione del pacchetto per un invio di un pacchetto in anteprima. Per ulteriori informazioni sul processo di creazione di un invio di un'app mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di app.

Prerequisiti

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

  • Se non lo si è 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.
  • Creare un invio per una delle app. È possibile eseguire questa operazione nel Centro per i partner, oppure usando il metodo di creazione di un invio di un'app.

Richiedi

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

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

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 l'invio con informazioni sull'implementazione del pacchetto che si desidera ottenere. Per ulteriori informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
submissionId string Obbligatorio. ID dell'invio con le informazioni sull'implementazione del pacchetto che si desidera ottenere. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un invio di un'app. Per un invio creato nel Centro per i partner, questo ID è disponibile anche nell'URL per la pagina di invio 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 ottenere informazioni sull'implementazione del pacchetto per un invio di un'app.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243649/packagerollout 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 un invio di un'app con implementazione graduale del pacchetto abilitata. Per ulteriori dettagli sui valori nel corpo della risposta, vedere Risorsa implementazione pacchetto.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Se per l'invio dell'app non è abilitata l'implementazione del pacchetto graduale, verrà restituito il corpo della risposta seguente.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

Codici di errore

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

Codice di errore Descrizione
404 L'invio non è stato trovato.
409 L'invio non appartiene all'app specificata o l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio di Microsoft Store.