Condividi tramite


Eseguire un invio di componente aggiuntivo

Usa questo metodo nell'API per l'invio in Microsoft Store per finalizzare l'invio di un componente aggiuntivo nuovo o aggiornato (noto anche come prodotto in-app o IAP) al Partner Center. L'azione di commit avvisa il Centro per i partner che i dati di invio sono stati caricati (incluse le icone correlate). In risposta, il Partner Center applica le modifiche ai dati di invio per l'inserimento e la pubblicazione. Al termine dell'operazione di commit, le modifiche apportate all'invio vengono visualizzate nel Centro per i partner.

Per altre informazioni sul modo in cui l'operazione di commit rientra nel processo di invio di un componente aggiuntivo tramite l'API di invio a Microsoft Store, vedi Gestire gli invii di componenti aggiuntivi.

Prerequisiti

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

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
INSERISCI https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

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 la sottomissione di cui si vuole eseguire il commit. L'ID dello Store è disponibile nel Partner Center ed è incluso nei dati di risposta per le richieste di Ottenere tutti i componenti aggiuntivi e Creare un componente aggiuntivo.
ID di invio corda Obbligatorio. ID dell'invio che si desidera confermare. 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 eseguire il commit di un invio di componente aggiuntivo.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit 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. Per altri dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.

{
  "status": "CommitStarted"
}

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

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
400 I parametri della richiesta non sono validi.
404 Impossibile trovare l'invio specificato.
409 L'invio specificato è stato trovato ma non è stato possibile eseguirne il commit nello stato corrente oppure il componente aggiuntivo usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.