Condividi tramite

Verificare lo stato di una sottomissione di un componente aggiuntivo

Usa questo metodo nell'API di invio del Microsoft Store per ottenere lo stato dell'invio di un componente aggiuntivo (noto anche come prodotto nell'app o IAP). Per altre informazioni sul processo di creazione di un invio di componente aggiuntivo tramite l'API di invio del Microsoft Store, vedere Gestire gli invii di componenti aggiuntivi.

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.
  • Crea una sottomissione per un'estensione di una delle tue app. Puoi farlo nel Centro per i partner, oppure puoi farlo usando il metodo Creare un invio di componente aggiuntivo.

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/inappproducts/{inAppProductId}/submissions/{submissionId}/status

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
inAppProductId (identificativo del prodotto in-app) corda Obbligatorio. ID dello Store del componente aggiuntivo che contiene l'invio per il quale vuoi ottenere lo stato. L'ID dello Store è disponibile nel Centro per i partner.
ID di invio corda Obbligatorio. ID dell'invio per il quale vuoi ottenere lo stato. Questo ID è disponibile nei dati di risposta per le richieste di creare una sottomissione di 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.

Testo della richiesta

Non bisogna fornire il corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come ottenere lo stato dell'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>

Risposta

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 altri dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Corpo della risposta

Valore TIPO Descrizione
stato corda Stato dell'invio. Può trattarsi di uno dei valori seguenti:
  • Nessuno
  • Annullato
  • Impegno in attesa
  • Inizio del commit
  • CommittamentoFallito
  • In attesa di pubblicazione
  • Pubblicazione
  • Pubblicato
  • Errore di pubblicazione
  • Preelaborazione
  • Pre-elaborazione non riuscita
  • Certificazione
  • Certificazione fallita
  • Rilascio
  • Rilascio non riuscito
dettagli dello stato oggetto Contiene dettagli aggiuntivi sullo stato dell'invio, incluse le informazioni su eventuali errori. Per ulteriori informazioni, consultare la risorsa sui dettagli dello stato .

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
404 Non è stato possibile trovare la sottomissione.
409 Il componente aggiuntivo usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.
  • Last updated on