Condividi tramite

Aggiorna un nuovo invio di un pacchetto di distribuzione

  • Articolo

Usa questo metodo nell'API di invio a Microsoft Store per aggiornare un invio in anteprima di un pacchetto esistente. Dopo aver aggiornato correttamente un invio usando questo metodo, è necessario confermare l'invio per l'inserimento e la pubblicazione.

Per ulteriori informazioni su questo metodo 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:

  • 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 pacchetto in anteprima per una delle tue app. Puoi farlo nel Centro per i partner oppure usando il metodo di creazione di un invio di pacchetto in anteprima.

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

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 per cui vuoi aggiornare un invio di pacchetto in anteprima. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
flightId string Obbligatorio. L'ID dell'invio del pacchetto in anteprima per il quale desideri aggiornare un invio. Questo ID è disponibile nei dati di risposta per le richieste di creare un pacchetto in anteprima e ottenere 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. L'ID dell'invio da aggiornare. 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.
packageId string Obbligatorio. ID del pacchetto esistente.

Testo della richiesta

Il corpo della richiesta include i seguenti parametri.

Valore Tipo Descrizione
flightPackages array Contiene oggetti che forniscono informazioni dettagliate su ogni pacchetto nell'invio. Per altri dettagli sui valori nel corpo della risposta, vedere Risorsa invio pacchetto in anteprima. Quando si chiama questo metodo per aggiornare un invio di app, nel corpo della richiesta sono necessari solo i valori fileName, fileStatus, minimumDirectXVersion e minimumSystemRam. Gli altri valori vengono popolati dal Centro per i partner.
packageDeliveryOptions oggetto Contiene l'implementazione graduale del pacchetto e le impostazioni di aggiornamento obbligatorie per l'invio. Per altre informazioni, vedere Oggetto opzioni di recapito dei pacchetti.
targetPublishMode string Modalità di pubblicazione per l'invio. I valori possibili sono i seguenti:
  • Immediate
  • Manuale
  • SpecificDate
targetPublishDate string Data di pubblicazione per l'invio in formato ISO 8601, se targetPublishMode è impostato su SpecificDate.
notesForCertification string Fornisce informazioni aggiuntive per i tester di certificazione, ad esempio le credenziali dell'account di test e i passaggi per accedere e verificare le funzionalità. Per ulteriori informazioni, vedere Note per la certificazione.

Esempio di richiesta

L'esempio seguente illustra come aggiornare un invio di pacchetto in anteprima per un'app.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Response

Nell'esempio seguente viene illustrato il corpo della risposta JSON per una chiamata riuscita a questo metodo. Il corpo della risposta contiene informazioni sull'invio aggiornato. Per altri dettagli sui valori nel corpo della risposta, vedere Risorsa invio pacchetto in anteprima.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Codici di errore

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

Codice errore Description
400 Impossibile aggiornare l'invio del pacchetto in anteprima perché la richiesta non è valida.
409 Impossibile aggiornare l'invio del pacchetto in anteprima a causa dello stato corrente dell'app o l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.