Condividi tramite

Confermare un invio di un'app

Usa questo metodo nell'API di invio di Microsoft Store per confermare un nuovo invio di app o aggiornato al Partner Center. L'azione di commit avvisa il Centro per i partner che i dati di invio sono stati caricati (inclusi eventuali pacchetti e immagini correlati). 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'app tramite l'API di invio a Microsoft Store, vedi Gestire gli invii di app.

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.
  • Creare un invio di app e quindi aggiornare l'invio con le modifiche necessarie ai dati di invio.

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/applications/{applicationId}/submissions/{submissionId}/commit

Header di richiesta

Intestazione TIPO Descrizione
Autorizzazione corda Obbligatorio. Token di accesso di Azure AD nel formato Bearer<token>.

Parametri della richiesta

Nome TIPO Descrizione
ID dell'applicazione corda Obbligatorio. ID dello Store dell'app che contiene l'invio di cui si vuole eseguire il commit. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
ID di invio corda Obbligatorio. ID dell'invio che si desidera confermare. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un invio di 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.

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 app.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/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 l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.
  • Last updated on