Ottenere lo stato di un invio di un componente aggiuntivo
Usare questo metodo nell'API di invio di Microsoft Store per ottenere lo stato di un componente aggiuntivo (anche denominato prodotto in-app o IAP). Per ulteriori informazioni sul processo di creazione di un invio di un componente aggiuntivo mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di componenti aggiuntivi.
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.
- Creare un invio di un componente aggiuntivo per una delle app. È possibile eseguire questa operazione nel Centro per i partner, oppure usando il metodo di creazione di un invio di un componente aggiuntivo.
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/inappproducts/{inAppProductId}/submissions/{submissionId}/status |
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 |
---|---|---|
inAppProductId | string | Obbligatorio. ID dello Store del componente aggiuntivo che contiene l'invio per il quale si desidera ottenere lo stato. L'ID dello Store è disponibile nel Centro per i partner. |
submissionId | string | Obbligatorio. ID dell'invio per il quale si desidera ottenere lo stato. Questo ID è disponibile nei dati della risposta per le richieste di creazione di un invio di un componente aggiuntivo. 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 lo stato di un invio di un componente aggiuntivo.
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/status 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. Il corpo della risposta contiene informazioni sull'invio specificato. Per ulteriori dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.
{
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
}
Corpo della risposta
Valore | Tipo | Descrizione |
---|---|---|
stato | string | Lo stato dell'invio. Questo può essere uno dei seguenti valori:
|
statusDetails | oggetto | Contiene dettagli aggiuntivi sullo stato dell'invio, incluse informazioni su eventuali errori. Per ulteriori informazioni, vedere Risorsa dettagli stato. |
Codici di errore
Se la richiesta non può essere completata, la risposta conterrà uno dei codici di errore HTTP seguenti.
Codice errore | Descrizione |
---|---|
404 | Non è stato possibile trovare l'invio. |
409 | Il componente aggiuntivo usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio di Microsoft Store. |
Argomenti correlati
- Creare e gestire gli invii usando i servizi di Microsoft Store
- Ottenere un invio di un componente aggiuntivo
- Creare un invio di componente aggiuntivo
- Eseguire il commit di un invio di un componente aggiuntivo
- Aggiornare un invio di un componente aggiuntivo
- Eliminare un invio di un componente aggiuntivo