Aggiornare un invio di un'app

  • Articolo

Usa questo metodo nell'API di invio a Microsoft Store per aggiornare un invio di app 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'app mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di app.

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

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}/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. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
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 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.

Corpo della richiesta

Il corpo della richiesta include i seguenti parametri.

Valore Tipo Descrizione
applicationCategory string Stringa che specifica la categoria e/o la sottocategoria per l'app. Le categorie e le sottocategorie vengono combinate in una singola stringa con il carattere di sottolineatura '_', ad esempio BooksAndReference_EReader.
prezzi oggetto Oggetto che contiene informazioni sui prezzi per l'app. Per altre informazioni, vedere la sezione Determinare il prezzo della risorsa.
visibility string Visibilità dell'app. I valori possibili sono i seguenti:
  • Hidden
  • Pubblico
  • Privato
  • NotSet
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.
presentazioni oggetto Dizionario di coppie chiave e valore, in cui ogni chiave è un codice paese e ogni valore è un oggetto risorsa Listing che contiene informazioni di presentazione per l'app.
hardwarePreferences array Matrice di stringhe che definiscono le preferenzehardware per l'app. I valori possibili sono i seguenti:
  • Touch
  • Tastiera
  • Mouse
  • Fotocamera
  • NfcHce
  • Nfc
  • BluetoothLE
  • Telefonia
automaticBackupEnabled boolean Indica se Windows può includere i dati dell'app nei backup automatici in OneDrive. Per ulteriori informazioni, vedere Dichiarazioni di funzionalità delle app.
canInstallOnRemovableMedia boolean Indica se i clienti possono installare l'app in uno spazio di archiviazione rimovibile. Per ulteriori informazioni, vedere Dichiarazioni di funzionalità delle app.
isGameDvrEnabled boolean Indica se Game DVR è abilitato per l'app.
gamingOptions oggetto Matrice che contiene una risorsa di opzioni di gioco che definisce le impostazioni correlate al gioco per l'app.
hasExternalInAppProducts boolean Indica se l'app consente agli utenti di effettuare acquisti all'esterno del sistema commerciale di Microsoft Store. Per ulteriori informazioni, vedere Dichiarazioni di funzionalità delle app.
meetAccessibilityGuidelines boolean Indica se l'app è stata testata per soddisfare le linee guida per l'accessibilità. Per ulteriori informazioni, vedere Dichiarazioni di funzionalità delle app.
notesForCertification string Contiene note per la certificazione per l'app.
applicationPackages array Contiene oggetti che forniscono informazioni dettagliate su ogni pacchetto nell'invio. Per altre informazioni, vedere la sezione pacchetto dell'applicazione. 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.
enterpriseLicensing string Uno dei valori delle licenze aziendali che indicano il comportamento delle licenze aziendali per l'app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies boolean Indica se Microsoft è autorizzato a rendere disponibile l'app per le future famiglie di dispositivi Windows 10 e Windows 11.
allowTargetFutureDeviceFamilies boolean Indica se l'app è consentita per le future famiglie di dispositivi Windows 10 e Windows 11.
trailer array Matrice che contiene fino a risorse trailer che rappresentano trailer video per l'inserzione dell'app.

Esempio di richiesta

L'esempio seguente illustra come aggiornare un invio di un'app.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
		      "epub"
		    ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
		      "Free ebook reader"
		    ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.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"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

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 ulteriori dettagli sui valori nel corpo della risposta, vedere Risorsa di invio dell'app.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1",
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

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 perché la richiesta non è valida.
409 Impossibile aggiornare l'invio a causa dello stato corrente dell'app o perché l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.