Condividi tramite

Eseguire il commit di un pacchetto in anteprima

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per eseguire il commit dell'invio al Centro per i partner di un pacchetto in anteprima nuovo o aggiornato. L'azione di commit avvisa il Centro per i partner che i dati di invio sono stati caricati (inclusi eventuali pacchetti correlati). In risposta, il Centro per i partner esegue il commit delle modifiche apportate 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 ulteriori informazioni sull'operazione di commit nell'ambito del processo di creazione di un invio di un pacchetto in anteprima mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di pacchetti in anteprima.

Prerequisiti

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

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
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit

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 del pacchetto in anteprima di cui si desidera eseguire il commit. L'ID dello Store per l'app è disponibile nel Centro per i partner.
flightId string Obbligatorio. ID del pacchetto in anteprima che contiene l'invio di cui si esegue il commit. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un pacchetto in anteprima e recupero dei pacchetti in anteprima per un'app. Per una distribuzione in anteprima creata nel Centro per i partner, questo ID è disponibile anche nell'URL per la pagina distribuzione in anteprima nel Centro per i partner.
submissionId string Obbligatorio. ID dell'invio di cui si esegue il commit. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un invio di pacchetto in anteprima. 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 eseguire il commit di un invio di un pacchetto in anteprima.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit 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 ulteriori dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.

{
  "status": "CommitStarted"
}

Corpo della risposta

Valore Tipo Descrizione
stato string Lo stato dell'invio. Questo può essere uno dei seguenti valori:
  • None
  • Annullati
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Pubblicazione
  • Pubblicazione completata
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Certification
  • CertificationFailed
  • Versione
  • ReleaseFailed

Codici di errore

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

Codice errore Description
400 I parametri della richiesta non sono validi.
404 L'invio specificato non è stato trovato.
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 di Microsoft Store.