Aggiornare un invio di appUpdate an app submission

Usare questo metodo nell'API di invio Microsoft Store per aggiornare un invio di app esistente.Use this method in the Microsoft Store submission API to update an existing app submission. Dopo aver aggiornato un invio con questo metodo, devi confermare l'invio per l'inserimento e la pubblicazione.After you successfully update a submission by using this method, you must commit the submission for ingestion and publishing.

Per altre informazioni sul modo in cui questo metodo si integra nel processo di creazione di un invio di app usando l'API di invio Microsoft Store, vedere gestire gli invii di app.For more information about how this method fits into the process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

PrerequisitiPrerequisites

Per usare questo metodo, devi prima eseguire le operazioni seguenti:To use this method, you need to first do the following:

  • Se non è già stato fatto, completare tutti i prerequisiti per l'API di invio Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Ottieni un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo.Obtain an Azure AD access token to use in the request header for this method. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza.After you obtain an access token, you have 60 minutes to use it before it expires. Dopo la scadenza del token, puoi ottenerne uno nuovo.After the token expires, you can obtain a new one.
  • Creare un invio per una delle app.Create a submission for one of your apps. Questa operazione può essere eseguita nel centro per i partner oppure è possibile usare il metodo Create an app Submission .You can do this in Partner Center, or you can do this by using the create an app submission method.

RichiestaRequest

La sintassi di questo metodo è la seguente.This method has the following syntax. Vedi le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del contenuto della richiesta.See the following sections for usage examples and descriptions of the header and request body.

MetodoMethod URI richiestaRequest URI
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Intestazione della richiestaRequest header

IntestazioneHeader TipoType DescrizioneDescription
AutorizzazioneAuthorization stringstring Obbligatorio.Required. Il token di accesso Azure ad nel token di connessione del modulo < token > .The Azure AD access token in the form Bearer <token>.

Parametri della richiestaRequest parameters

NomeName TipoType DescrizioneDescription
applicationIdapplicationId stringstring Obbligatorio.Required. ID dello Store dell'app per cui vuoi aggiornare un invio.The Store ID of the app for which you want to update a submission. Per altre informazioni sull'ID dello Store, vedi Visualizzare i dettagli dell'identità dell'app.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Obbligatorio.Required. ID dell'invio da aggiornare.The ID of the submission to update. Questo ID è disponibile nei dati della risposta per le richieste di creazione di un invio dell'app.This ID is available in the response data for requests to create an app submission. Per un invio creato in Partner Center, questo ID è disponibile anche nell'URL per la pagina di invio nel centro per i partner.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corpo della richiestaRequest body

I parametri del contenuto della richiesta sono i seguenti.The request body has the following parameters.

ValoreValue TipoType DescrizioneDescription
applicationCategoryapplicationCategory stringstring Stringa che specifica la categoria e/o sottocategoria per la tua app.A string that specifies the category and/or subcategory for your app. Categorie e sottocategorie vengono combinate in una singola stringa con un carattere di sottolineatura "", ad esempio BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '' character, such as BooksAndReference_EReader.
prezzipricing objectobject Oggetto che contiene informazioni sui prezzi per l'app.An object that contains pricing info for the app. Per altre informazioni, vedi la sezione relativa alla risorsa prezzi.For more information, see the Pricing resource section.
visibilityvisibility stringstring Visibilità dell'app.The visibility of the app. I valori possibili sono i seguenti:This can be one of the following values:
  • NascostoHidden
  • PubblicoPublic
  • PrivatiPrivate
  • NotSetNotSet
targetPublishModetargetPublishMode stringstring Modalità di pubblicazione per l'invio.The publish mode for the submission. I valori possibili sono i seguenti:This can be one of the following values:
  • ImmediatoImmediate
  • ManualeManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring Data di pubblicazione per l'invio nel formato ISO 8601, se targetPublishMode è impostato su SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
listingslistings objectobject Dizionario di coppie chiave/valore, in cui ogni chiave è un codice paese e ogni valore è un oggetto risorsa presentazione che contiene le informazioni sulla presentazione per l'app.A dictionary of key and value pairs, where each key is a country code and each value is a Listing resource object that contains listing info for the app.
hardwarePreferenceshardwarePreferences arrayarray Matrice di stringhe che definisce le preferenze hardware per la tua app.An array of strings that define the hardware preferences for your app. I valori possibili sono i seguenti:This can be one of the following values:
  • ToccoTouch
  • TastieraKeyboard
  • MouseMouse
  • FotocameraCamera
  • NfcHceNfcHce
  • NfcNfc
  • BluetoothLEBluetoothLE
  • TelephonyTelephony
automaticBackupEnabledautomaticBackupEnabled booleanboolean Indica se Windows può includere i dati dell'app nei backup automatici in OneDrive.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Per altre informazioni, vedi Dichiarazioni per le app.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean Indica se i clienti possono installare l'app in dispositivi di archiviazione rimovibili.Indicates whether customers can install your app to removable storage. Per altre informazioni, vedi Dichiarazioni per le app.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean Indica se Game DVR è abilitato per l'app.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions objectobject Matrice che contiene una risorsa opzioni di gioco che definisce le impostazioni relative ai giochi per l'app.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean Indica se l'app consente agli utenti di effettuare acquisti all'esterno del sistema Microsoft Store Commerce.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Per altre informazioni, vedi Dichiarazioni per le app.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean Indica se l'app è stata testata per il rispetto delle linee guida di accessibilità.Indicates whether your app has been tested to meet accessibility guidelines. Per altre informazioni, vedi Dichiarazioni per le app.For more information, see App declarations.
notesForCertificationnotesForCertification stringstring Contiene le note sulla certificazione per la tua app.Contains notes for certification for your app.
applicationPackagesapplicationPackages arrayarray Contiene oggetti che forniscono informazioni dettagliate su ogni pacchetto nell'invio.Contains objects that provide details about each package in the submission. Per altre informazioni, vedi la sezione Pacchetto dell'applicazione.For more information, see the Application package section. Quando chiami questo metodo per aggiornare un invio di app, nel contenuto della richiesta sono necessari solo i valori fileName, fileStatus, minimumDirectXVersion e minimumSystemRam di questi oggetti.When calling this method to update an app submission, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of these objects are required in the request body. Gli altri valori vengono popolati dal centro per i partner.The other values are populated by Partner Center.
packageDeliveryOptionspackageDeliveryOptions objectobject Contiene le impostazioni per l'implementazione graduale del pacchetto e l'aggiornamento obbligatorio per l'invio.Contains gradual package rollout and mandatory update settings for the submission. Per altre informazioni, vedi Oggetto per le opzioni di recapito dei pacchetti.For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing stringstring Uno dei valori per la gestione delle licenze aziendali che indicano il comportamento della gestione delle licenze aziendali per l'app.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean Indica se Microsoft è autorizzata a rendere disponibile l'app per le famiglie di dispositivi Windows 10 future.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanboolean Indica se all'app è consentito avere come destinazione famiglie di dispositivi Windows 10 future.Indicates whether your app is allowed to target future Windows 10 device families.
i trailertrailers arrayarray Matrice contenente fino a risorse trailer che rappresentano i trailer video per l'elenco delle app.An array that contains up to trailer resources that represent video trailers for the app listing.

Esempio di richiestaRequest example

L'esempio seguente illustra come aggiornare un invio di app.The following example demonstrates how to update an app submission.

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": []
}

RispostaResponse

L'esempio seguente illustra il contenuto della risposta JSON per una chiamata a questo metodo.The following example demonstrates the JSON response body for a successful call to this method. Il contenuto della risposta contiene informazioni sull'invio aggiornato.The response body contains information about the updated submission. Per altri dettagli sui valori nel contenuto della risposta, vedi la risorsa invio di app.For more details about the values in the response body, see App submission resource.

{
  "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 erroreError codes

Se la richiesta non può essere completata, la risposta conterrà uno dei seguenti codici di errore HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Codice di erroreError code DescrizioneDescription
400400 Non è stato possibile aggiornare l'invio perché la richiesta non è valida.The submission could not be updated because the request is invalid.
409409 Non è stato possibile aggiornare l'invio 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 Microsoft Store.The submission could not be updated because of the current state of the app, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.