Gestire gli invii di appManage app submissions

L'API di invio Microsoft Store fornisce i metodi che è possibile usare per gestire gli invii per le app, incluso il pacchetto graduale rollout.The Microsoft Store submission API provides methods you can use to manage submissions for your apps, including gradual package rollouts. Per un'introduzione all'API di invio Microsoft Store, inclusi i prerequisiti per l'uso dell'API, vedere creare e gestire invii con Microsoft Store Services.For an introduction to the Microsoft Store submission API, including prerequisites for using the API, see Create and manage submissions using Microsoft Store services.

Importante

Se si usa l'API di invio Microsoft Store per creare un invio per un'app, assicurarsi di apportare ulteriori modifiche all'invio solo usando l'API, anziché il centro per i partner.If you use the Microsoft Store submission API to create a submission for an app, be sure to make further changes to the submission only by using the API, rather than Partner Center. Se si usa centro per i partner per modificare un invio creato originariamente con l'API, non sarà più possibile modificare o eseguire il commit dell'invio tramite l'API.If you use Partner Center to change a submission that you originally created by using the API, you will no longer be able to change or commit that submission by using the API. In alcuni casi, è possibile che l'invio venga lasciato in uno stato di errore in cui non è possibile continuare il processo di invio.In some cases, the submission could be left in an error state where it cannot proceed in the submission process. In tal caso, è necessario eliminare l'invio e creare un nuovo invio.If this occurs, you must delete the submission and create a new submission.

Importante

Non è possibile usare questa API per pubblicare invii per gli acquisti di volumi tramite il Microsoft Store for business e Microsoft Store per la formazione o per pubblicare invii per le app LOB direttamente nelle aziende.You cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education or to publish submissions for LOB apps directly to enterprises. Per entrambi questi scenari, è necessario usare il centro per i partner per pubblicare l'invio.For both of these scenarios, you must use Partner Center to publish the submission.

Metodi per la gestione degli invii di appMethods for managing app submissions

Per ottenere, creare, aggiornare, confermare o eliminare l'invio di app, usa i metodi seguenti:Use the following methods to get, create, update, commit, or delete an app submission. Prima di poter usare questi metodi, l'app deve esistere già nell'account del centro per i partner ed è necessario prima creare un invio per l'app nel centro per i partner.Before you can use these methods, the app must already exist in your Partner Center account and you must first create one submission for the app in Partner Center. Per ulteriori informazioni, vedere i prerequisiti.For more information, see the prerequisites.

MetodoMethod URIURI DescrizioneDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Ottiene un invio di un'app esistente.Get an existing app submission
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status Ottiene lo stato di un invio di un'app esistente.Get the status of an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions Crea un nuovo invio di app.Create a new app submission
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Aggiorna un invio di un'app esistente.Update an existing app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit Conferma un invio di un'app nuova o aggiornata.Commit a new or updated app submission
DELETEDELETE https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} Elimina un invio di app.Delete an app submission

Creare un invio di appCreate an app submission

Per creare un invio per un'app, segui questa procedura.To create a submission for an app, follow this process.

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

    Nota

    Assicurarsi che l'app disponga già di almeno un invio completato con le informazioni relative alle classificazioni di età completate.Make sure the app already has at least one completed submission with the age ratings information completed.

  2. Ottenere un token di accesso Azure ad.Obtain an Azure AD access token. È necessario passare questo token di accesso ai metodi nell'API di invio Microsoft Store.You must pass this access token to the methods in the Microsoft Store submission API. 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.

  3. Creare l'invio di un'app eseguendo il metodo seguente nell'API di invio Microsoft Store.Create an app submission by executing the following method in the Microsoft Store submission API. Questo metodo crea un nuovo invio in corso, che è una copia dell'ultimo invio pubblicato.This method creates a new in-progress submission, which is a copy of your last published submission.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions
    

    Il corpo della risposta contiene una risorsa di invio dell'app che include l'ID del nuovo invio, l'URI della firma di accesso condiviso per il caricamento di tutti i file correlati per l'invio all'archivio BLOB di Azure, ad esempio i pacchetti dell'app, le immagini di elenco e i file trailer, e tutti i dati per il nuovo invio, ad esempio le informazioni sui prezzi e le inserzioni.The response body contains an app submission resource that includes the ID of the new submission, the shared access signature (SAS) URI for uploading any related files for the submission to Azure Blob storage (such as app packages, listing images, and trailer files), and all of the data for the new submission (such as the listings and pricing information).

    Nota

    Un URI di firma di accesso condiviso fornisce l'accesso a una risorsa sicura in archiviazione di Azure senza richiedere chiavi dell'account.A SAS URI provides access to a secure resource in Azure storage without requiring account keys. Per informazioni generali sugli URI delle firme di accesso condiviso e sul loro utilizzo nell'archiviazione BLOB di Azure, vedi Firme di accesso condiviso, parte 1: informazioni di base sul modello delle firme di accesso condiviso e Firme di accesso condiviso, parte 2: creare e usare una firma di accesso condiviso con l'archiviazione BLOB.For background information about SAS URIs and their use with Azure Blob storage, see Shared Access Signatures, Part 1: Understanding the SAS model and Shared Access Signatures, Part 2: Create and use a SAS with Blob storage.

  4. Se si aggiungono nuovi pacchetti, un elenco di immagini o file di trailer per l'invio, preparare i pacchetti dell'app e preparare gli screenshot, le immagini e i trailer dell'app.If you are adding new packages, listing images, or trailer files for the submission, prepare the app packages and prepare the app screenshots, images, and trailers. Aggiungi tutti questi file in un archivio ZIP.Add all of these files to a ZIP archive.

  5. Rivedere i dati di invio dell'app con le modifiche necessarie per il nuovo invio ed eseguire il metodo seguente per aggiornare l'invio dell'app.Revise the app submission data with any required changes for the new submission, and execute the following method to update the app submission.

    PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}
    

    Nota

    Se si aggiungono nuovi file per l'invio, assicurarsi di aggiornare i dati di invio in modo che facciano riferimento al nome e al percorso relativo di questi file nell'archivio ZIP.If you are adding new files for the submission, make sure you update the submission data to refer to the name and relative path of these files in the ZIP archive.

  6. Se si aggiungono nuovi pacchetti, un elenco di immagini o file trailer per l'invio, caricare l'archivio ZIP nell'archivio BLOB di Azure usando l'URI di firma di accesso condiviso fornito nel corpo della risposta del metodo post chiamato in precedenza.If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive to Azure Blob storage using the SAS URI that was provided in the response body of the POST method you called earlier. Sono disponibili diverse librerie di Azure che puoi usare per questo scopo su molte piattaforme, incluse:There are different Azure libraries you can use to do this on a variety of platforms, including:

    L'esempio di codice C# seguente illustra come caricare un archivio ZIP nell'archiviazione BLOB di Azure tramite la classe CloudBlockBlob nella libreria client di Archiviazione di Azure per .NET.The following C# code example demonstrates how to upload a ZIP archive to Azure Blob storage using the CloudBlockBlob class in the Azure Storage Client Library for .NET. In questo esempio si presuppone che l'archivio ZIP sia già stato scritto in un oggetto del flusso.This example assumes that the ZIP archive has already been written to a stream object.

    string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
    Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
        new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
    await blockBob.UploadFromStreamAsync(stream);
    
  7. Conferma l'invio di app eseguendo il metodo seguente.Commit the app submission by executing the following method. Verrà avvisato il centro per i partner che l'utente ha completato l'invio e che ora gli aggiornamenti verranno applicati al proprio account.This will alert Partner Center that you are done with your submission and that your updates should now be applied to your account.

    POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/commit
    
  8. Controlla lo stato di conferma eseguendo il metodo seguente per ottenere lo stato dell'invio di app.Check on the commit status by executing the following method to get the status of the app submission.

    GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status
    

    Per verificare lo stato dell'invio, esamina il valore status nel corpo della risposta.To confirm the submission status, review the status value in the response body. Questo valore dovrebbe cambiare da CommitStarted in PreProcessing se la richiesta ha esito positivo oppure in CommitFailed se sono presenti errori nella richiesta.This value should change from CommitStarted to either PreProcessing if the request succeeds or to CommitFailed if there are errors in the request. Se sono presenti errori, il campo statusDetails contiene maggiori dettagli sull'errore.If there are errors, the statusDetails field contains further details about the error.

  9. Una volta completata la conferma, l'invio viene inviato allo Store per l'inserimento.After the commit has successfully completed, the submission is sent to the Store for ingestion. È possibile continuare a monitorare lo stato di avanzamento dell'invio usando il metodo precedente o visitando il centro per i partner.You can continue to monitor the submission progress by using the previous method, or by visiting Partner Center.

Metodi per la gestione di un'implementazione graduale del pacchettoMethods for managing a gradual package rollout

Puoi implementare gradualmente i pacchetti aggiornati in un invio di app a una percentuale di clienti della tua app con Windows 10.You can gradually roll out the updated packages in an app submission to a percentage of your app’s customers on Windows 10. Questo ti consente di monitorare il feedback e i dati analitici per i pacchetti specifici per essere certo dell'aggiornamento prima di implementarlo più diffusamente.This allows you to monitor feedback and analytic data for the specific packages to make sure you’re confident about the update before rolling it out more broadly. Puoi modificare la percentuale di implementazione (o interrompere l'aggiornamento) per un invio pubblicato senza dover creare un nuovo invio.You can change the rollout percentage (or halt the update) for a published submission without having to create a new submission. Per altri dettagli, incluse le istruzioni su come abilitare e gestire un'implementazione graduale dei pacchetti nel centro per i partner, vedere questo articolo.For more details, including instructions for how to enable and manage a gradual package rollout in Partner Center, see this article.

Per abilitare a livello di codice un'implementazione graduale dei pacchetti per l'invio di un'app, seguire questa procedura usando i metodi dell'API di invio Microsoft Store:To programmatically enable a gradual package rollout for an app submission, follow this process using methods in the Microsoft Store submission API:

  1. Crea un invio di app oppure ottieni un invio di app esistente.Create an app submission or get an existing app submission.
  2. Nei dati di risposta individuare la risorsa packageRollout , impostare il campo isPackageRollout su truee impostare il campo packageRolloutPercentage sulla percentuale dei clienti dell'app che dovrebbero ottenere i pacchetti aggiornati.In the response data, locate the packageRollout resource, set the isPackageRollout field to true, and set the packageRolloutPercentage field to the percentage of your app's customers who should get the updated packages.
  3. Passa i dati dell'invio di app aggiornato al metodo per aggiornare un invio di app.Pass the updated app submission data to the update an app submission method.

Dopo che un'implementazione graduale del pacchetto è abilitata per un invio di app, puoi usare i metodi seguenti per ottenere, aggiornare, interrompere o finalizzare a livello di codice l'implementazione graduale.After a gradual package rollout is enabled for an app submission, you can use the following methods to programmatically get, update, halt, or finalize the gradual rollout.

MetodoMethod URIURI DescrizioneDescription
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout Ottiene informazioni sull'implementazione graduale per un invio di app.Get the gradual rollout info for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage Aggiorna la percentuale di implementazione graduale per un invio di app.Update the gradual rollout percentage for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout Interrompe l'implementazione graduale per un invio di app.Halt the gradual rollout for an app submission
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/finalizepackagerollout Finalizza l'implementazione graduale per un invio di app.Finalize the gradual rollout for an app submission

Esempi di codice per la gestione degli invii di appCode examples for managing app submissions

Gli articoli seguenti contengono esempi di codice dettagliati che illustrano come creare un invio di app in diversi linguaggi di programmazione:The following articles provide detailed code examples that demonstrate how to create an app submission in several different programming languages:

Modulo StoreBroker di PowerShellStoreBroker PowerShell module

In alternativa alla chiamata diretta all'API di invio Microsoft Store, viene fornito anche un modulo di PowerShell open source che implementa un'interfaccia della riga di comando all'inizio dell'API.As an alternative to calling the Microsoft Store submission API directly, we also provide an open-source PowerShell module which implements a command-line interface on top of the API. Questo modulo è denominato StoreBroker.This module is called StoreBroker. È possibile usare questo modulo per gestire gli invii di app, voli e componenti aggiuntivi dalla riga di comando anziché chiamare direttamente l'API di invio Microsoft Store oppure è sufficiente esplorare l'origine per visualizzare altri esempi su come chiamare questa API.You can use this module to manage your app, flight, and add-on submissions from the command line instead of calling the Microsoft Store submission API directly, or you can simply browse the source to see more examples for how to call this API. Il modulo StoreBroker viene usato attivamente in Microsoft come metodo principale per l'invio di molte applicazioni di prima entità allo Store.The StoreBroker module is actively used within Microsoft as the primary way that many first-party applications are submitted to the Store.

Per altre informazioni, vedere la pagina StoreBroker su GitHub.For more information, see our StoreBroker page on GitHub.

Risorse datiData resources

I metodi dell'API di invio Microsoft Store per la gestione degli invii di app usano le risorse di dati JSON seguenti.The Microsoft Store submission API methods for managing app submissions use the following JSON data resources.

Risorsa invio appApp submission resource

Questa risorsa descrive un invio di app.This resource describes an app submission.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2",
    "isAdvancedPricingModel": true
  },
  "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",
            "description": "Main page",
            "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": "Uploaded",
      "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": []
}

I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
idid stringstring ID dell'invio.The ID of the submission. Questo ID è disponibile nei dati della risposta per le richieste di creazione di un invio dell'app, per ottenere tutte leapp e per ottenere un'app.This ID is available in the response data for requests to create an app submission, get all apps, and get an app. 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.
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 Una risorsa risorsa prezzi che contiene info sui prezzi per l'app.A pricing resource that contains pricing info for the app.
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 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 arrayarray 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.
statusstatus stringstring Stato dell'invio.The status of the submission. I valori possibili sono i seguenti:This can be one of the following values:
  • NessunoNone
  • CancellatiCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PubblicazionePublishing
  • PubblicatoPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificazioneCertification
  • CertificationFailedCertificationFailed
  • VersioneRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails objectobject Una risorsa dettagli sullo stato che contiene informazioni aggiuntive sullo stato dell'invio, incluse informazioni su eventuali errori.A status details resource that contains additional details about the status of the submission, including information about any errors.
fileUploadUrlfileUploadUrl stringstring URI della firma di accesso condiviso per caricare i pacchetti per l'invio.The shared access signature (SAS) URI for uploading any packages for the submission. Se si aggiungono nuovi pacchetti, un elenco di immagini o file trailer per l'invio, caricare l'archivio ZIP che contiene i pacchetti e le immagini in questo URI.If you are adding new packages, listing images, or trailer files for the submission, upload the ZIP archive that contains the packages and images to this URI. Per altre informazioni, vedi Creare un invio di app.For more information, see Create an app submission.
applicationPackagesapplicationPackages arrayarray Un array di risorse pacchetto di applicazione che forniscono informazioni dettagliate su ogni pacchetto nell'invio.An array of application package resources that provide details about each package in the submission.
packageDeliveryOptionspackageDeliveryOptions objectobject Una risorsa opzioni recapito pacchetti che contiene le impostazioni per l'implementazione graduale del pacchetto e l'aggiornamento obbligatorio per l'invio.A package delivery options resource that contains gradual package rollout and mandatory update settings for the submission.
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.
allowMicrosoftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies 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 objectobject Dizionario di coppie chiave/valore, in cui ogni chiave è una famiglia di dispositivi Windows 10 e ogni valore è un valore booleano che indica se l'app può usare la famiglia di dispositivi specificata come destinazione.A dictionary of key and value pairs, where each key is a Windows 10 device family and each value is a boolean that indicates whether your app is allowed to target the specified device family.
friendlyNamefriendlyName stringstring Nome descrittivo dell'invio, come illustrato in centro per i partner.The friendly name of the submission, as shown in Partner Center. Questo valore viene generato automaticamente quando si crea l'invio.This value is generated for you when you create the submission.
i trailertrailers arrayarray Matrice contenente fino a 15 risorse trailer che rappresentano i trailer video per l'elenco delle app.An array that contains up to 15 trailer resources that represent video trailers for the app listing.

Risorsa prezziPricing resource

Questa risorsa contiene info sui prezzi per l'app.This resource contains pricing info for the app. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
trialPeriodtrialPeriod stringstring Stringa che specifica il periodo di prova per l'app.A string that specifies the trial period for the app. I valori possibili sono i seguenti:This can be one of the following values:
  • NoFreeTrialNoFreeTrial
  • OneDayOneDay
  • TrialNeverExpiresTrialNeverExpires
  • SevenDaysSevenDays
  • FifteenDaysFifteenDays
  • ThirtyDaysThirtyDays
marketSpecificPricingsmarketSpecificPricings objectobject Dizionario di coppie chiave/valore, in cui ogni chiave è un codice paese ISO 3166-1 alpha-2 di due lettere e ogni valore è un livello di prezzo.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Questi elementi rappresentano prezzi personalizzati per l'app in mercati specifici.These items represent the custom prices for your app in specific markets. Tutti gli elementi in questo dizionario sostituiscono il prezzo di base specificato dal valore priceId per il mercato specificato.Any items in this dictionary override the base price specified by the priceId value for the specified market.
salessales arrayarray Deprecato.Deprecated. Un array di risorse vendita con informazioni sulla vendita per l'app.An array of sale resources that contain sales information for the app.
priceIdpriceId stringstring Livello di prezzo che specifica il prezzo di base per l'app.A price tier that specifies the base price for the app.
isAdvancedPricingModelisAdvancedPricingModel booleanboolean Se true, l'account sviluppatore ha accesso al set esteso di piani tariffari da 99 usd a 1999,99 USD.If true, your developer account has access to the expanded set of price tiers from .99 USD to 1999.99 USD. Se false, l'account sviluppatore ha accesso al set originale di piani tariffari da 99 usd a 999,99 USD.If false, your developer account has access to the original set of price tiers from .99 USD to 999.99 USD. Per altre informazioni sui diversi livelli, vedere livelli di Prezzo.For more information about the different tiers, see price tiers.

Note   Nota   Questo campo è di sola lettura.Note  This field is read-only.

Risorsa venditaSale resource

Questa risorsa contiene info per la vendita di un'app.This resources contains sale info for an app.

Importante

La risorsa vendita non è più supportata e attualmente non è possibile ottenere o modificare i dati di vendita per l'invio di un'app usando l'API di invio Microsoft Store.The Sale resource is no longer supported, and currently you cannot get or modify the sale data for an app submission using the Microsoft Store submission API. In futuro, l'API di invio Microsoft Store viene aggiornata per introdurre un nuovo modo per accedere a livello di codice alle informazioni di vendita per gli invii di app.In the future, we will update the Microsoft Store submission API to introduce a new way to programmatically access sales information for app submissions.

  • Dopo aver chiamato il metodo GET per ottenere un invio di app, il valore sales sarà vuoto.After calling the GET method to get an app submission, the sales value will be empty. È possibile continuare a usare il centro per i partner per ottenere i dati di vendita per l'invio dell'app.You can continue to use Partner Center to get the sale data for your app submission.
  • Quando chiami il metodo PUT per aggiornare un invio di app, le informazioni contenute nel valore sales vengono ignorate.When calling the PUT method to update an app submission, the information in the sales value is ignored. È possibile continuare a usare il centro per i partner per modificare i dati di vendita per l'invio dell'app.You can continue to use Partner Center to change the sale data for your app submission.

I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
namename stringstring Nome della vendita.The name of the sale.
basePriceIdbasePriceId stringstring Livello di prezzo da usare per il prezzo di base della vendita.The price tier to use for the base price of the sale.
startDatestartDate stringstring Data di inizio per la vendita nel formato ISO 8601.The start date for the sale in ISO 8601 format.
endDateendDate stringstring Data di fine per la vendita nel formato ISO 8601.The end date for the sale in ISO 8601 format.
marketSpecificPricingsmarketSpecificPricings objectobject Dizionario di coppie chiave/valore, in cui ogni chiave è un codice paese ISO 3166-1 alpha-2 di due lettere e ogni valore è un livello di prezzo.A dictionary of key and value pairs, where each key is a two-letter ISO 3166-1 alpha-2 country code and each value is a price tier. Questi elementi rappresentano prezzi personalizzati per l'app in mercati specifici.These items represent the custom prices for your app in specific markets. Tutti gli elementi in questo dizionario sostituiscono il prezzo di base specificato dal valore basePriceId per il mercato specificato.Any items in this dictionary override the base price specified by the basePriceId value for the specified market.

Risorsa presentazioneListing resource

Questa risorsa contiene info di presentazione per un'app.This resource contains listing info for an app. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
baseListingbaseListing objectobject Info di presentazione di base per l'app, che definiscono le info di presentazione predefinite per tutte le piattaforme.The base listing info for the app, which defines the default listing info for all platforms.
platformOverridesplatformOverrides objectobject Dizionario di coppie chiave/valore, in cui ogni chiave è una stringa che identifica una piattaforma per cui eseguire l'override delle info di presentazione, mentre ogni valore è un risorsa presentazione di base (contenente solo i valori dalla descrizione al titolo) che specifica le info di presentazione di cui eseguire l'override per la piattaforma specificata.A dictionary of key and value pairs, where each key is string that identifies a platform for which to override the listing info, and each value is a base listing resource (containing only the values from description to title) that specifies the listing info to override for the specified platform. I valori possibili per le chiavi sono i seguenti:The keys can have the following values:
  • SconosciutoUnknown
  • Windows80Windows80
  • Windows81Windows81
  • WindowsPhone71WindowsPhone71
  • WindowsPhone80WindowsPhone80
  • WindowsPhone81WindowsPhone81

Risorsa presentazione di baseBase listing resource

Questa risorsa contiene le info di presentazione di base per un'app.This resource contains base listing info for an app. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
copyrightAndTrademarkInfocopyrightAndTrademarkInfo stringstring Info su copyright e/o marchi facoltative.Optional copyright and/or trademark info.
keywordskeywords arrayarray Matrice di parole chiave per l'inclusione della tua app nei risultati di ricerca.An array of keyword to help your app appear in search results.
licenseTermslicenseTerms stringstring Condizioni di licenza facoltative per la tua app.The optional license terms for your app.
privacyPolicyprivacyPolicy stringstring Questo valore è obsoleto.This value is obsolete. Per impostare o modificare l'URL dell'informativa sulla privacy per l'app, è necessario eseguire questa operazione nella pagina delle Proprietà del centro per i partner.To set or change the privacy policy URL for your app, you must do this on the Properties page in Partner Center. È possibile omettere questo valore dalle chiamate all'API di invio.You can omit this value from your calls to the submission API. Se si imposta questo valore, verrà ignorato.If you set this value, it will be ignored.
supportContactsupportContact stringstring Questo valore è obsoleto.This value is obsolete. Per impostare o modificare l'URL del contatto di supporto o l'indirizzo di posta elettronica per l'app, è necessario eseguire questa operazione nella pagina Proprietà del centro per i partner.To set or change the support contact URL or email address for your app, you must do this on the Properties page in Partner Center. È possibile omettere questo valore dalle chiamate all'API di invio.You can omit this value from your calls to the submission API. Se si imposta questo valore, verrà ignorato.If you set this value, it will be ignored.
websiteUrlwebsiteUrl stringstring Questo valore è obsoleto.This value is obsolete. Per impostare o modificare l'URL della pagina Web per l'app, è necessario eseguire questa operazione nella pagina delle Proprietà del centro per i partner.To set or change the URL of the web page for your app, you must do this on the Properties page in Partner Center. È possibile omettere questo valore dalle chiamate all'API di invio.You can omit this value from your calls to the submission API. Se si imposta questo valore, verrà ignorato.If you set this value, it will be ignored.
descriptiondescription stringstring Descrizione per la presentazione dell'app.The description for the app listing.
funzionalitàfeatures arrayarray Matrice composta da un massimo di 20 stringhe che elenca le funzionalità per la tua app.An array of up to 20 strings that list the features for your app.
releaseNotesreleaseNotes stringstring Note sulla versione per la tua appThe release notes for your app.
imagesimages arrayarray Array di risorse di immagine e icona per la presentazione dell'app.An array of image and icon resources for the app listing.
recommendedHardwarerecommendedHardware arrayarray Array composto da un massimo di 11 stringhe che elenca le configurazioni hardware consigliate per la tua app.An array of up to 11 strings that list the recommended hardware configurations for your app.
minimumHardwareminimumHardware stringstring Una matrice di un massimo di 11 stringhe che elenca le configurazioni hardware minime per l'app.An array of up to 11 strings that list the minimum hardware configurations for your app.
titletitle stringstring Titolo per la presentazione dell'app.The title for the app listing.
shortDescriptionshortDescription stringstring Usato solo per i giochi.Only used for games. Questa descrizione viene visualizzata nella sezione informazioni dell'hub giochi su Xbox One e aiuta i clienti a comprendere meglio il gioco.This description appears in the Information section of the Game Hub on Xbox One, and helps customers understand more about your game.
shortTitleshortTitle stringstring Una versione più breve del nome del prodotto.A shorter version of your product’s name. Se specificato, questo nome più breve può essere visualizzato in varie posizioni su Xbox One (durante l'installazione, in successioni e così via) al posto del titolo completo del prodotto.If provided, this shorter name may appear in various places on Xbox One (during installation, in Achievements, etc.) in place of the full title of your product.
sortTitlesortTitle stringstring Se il prodotto può essere alfabetico in modi diversi, è possibile immettere un'altra versione.If your product could be alphabetized in different ways, you can enter another version here. Questo può aiutare i clienti a trovare più rapidamente il prodotto durante la ricerca.This may help customers find the product more quickly when searching.
voiceTitlevoiceTitle stringstring Un nome alternativo per il prodotto che, se specificato, può essere usato nell'esperienza audio su Xbox One quando si usa Kinect o un auricolare.An alternate name for your product that, if provided, may be used in the audio experience on Xbox One when using Kinect or a headset.
devStudiodevStudio stringstring Specificare questo valore se si desidera includere un campo sviluppato da nell'elenco.Specify this value if you want to include a Developed by field in the listing. Il campo pubblicato da elenca il nome visualizzato dell'editore associato all'account, indipendentemente dal fatto che venga fornito un valore devStudio .(The Published by field will list the publisher display name associated with your account, whether or not you provide a devStudio value.)

Risorsa immagineImage resource

Questa risorsa contiene dati di immagine e icona per la presentazione di un'app.This resource contains image and icon data for an app listing. Per altre informazioni su immagini e icone per un elenco di app, vedere screenshot e immaginiper le app.For more information about images and icons for an app listing, see App screenshots and images. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
fileNamefileName stringstring Nome del file di immagine nell'archivio ZIP che hai caricato per l'invio.The name of the image file in the ZIP archive that you uploaded for the submission.
fileStatusfileStatus stringstring Stato del file di immagine.The status of the image file. I valori possibili sono i seguenti:This can be one of the following values:
  • NessunoNone
  • PendingUploadPendingUpload
  • CaricatoUploaded
  • PendingDeletePendingDelete
idid stringstring ID per l'immagine.The ID for the image. Questo valore viene fornito dal centro per i partner.This value is supplied by Partner Center.
descriptiondescription stringstring Descrizione per l'immagine.The description for the image.
imageTypeimageType stringstring Indica il tipo di immagine.Indicates the type of the image. Le stringhe seguenti sono attualmente supportate.The following strings are currently supported.

Immagini screenshot:Screenshot images:

  • Screenshot (usare questo valore per lo screenshot del desktop)Screenshot (use this value for the desktop screenshot)
  • MobileScreenshotMobileScreenshot
  • XboxScreenshotXboxScreenshot
  • SurfaceHubScreenshotSurfaceHubScreenshot
  • HoloLensScreenshotHoloLensScreenshot

Logo dello Store:Store logos:

  • StoreLogo9x16StoreLogo9x16
  • StoreLogoSquareStoreLogoSquare
  • Icona (usare questo valore per il logo 1:1 300 x 300 pixel)Icon (use this value for the 1:1 300 x 300 pixels logo)

Immagini promozionali:Promotional images:

  • PromotionalArt16x9PromotionalArt16x9
  • PromotionalArtwork2400X1200PromotionalArtwork2400X1200

Immagini Xbox:Xbox images:

  • XboxBrandedKeyArtXboxBrandedKeyArt
  • XboxTitledHeroArtXboxTitledHeroArt
  • XboxFeaturedPromotionalArtXboxFeaturedPromotionalArt

Immagini promozionali facoltative:Optional promotional images:

  • SquareIcon358X358SquareIcon358X358
  • BackgroundImage1000X800BackgroundImage1000X800
  • PromotionalArtwork414X180PromotionalArtwork414X180

Risorsa opzioni di giocoGaming options resource

Questa risorsa contiene le impostazioni relative ai giochi per l'app.This resource contains game-related settings for the app. I valori in questa risorsa corrispondono alle impostazioni del gioco per gli invii nel centro per i partner.The values in this resource correspond to the game settings for submissions in Partner Center.

{
  "gamingOptions": [
    {
      "genres": [
        "Games_ActionAndAdventure",
        "Games_Casino"
      ],
      "isLocalMultiplayer": true,
      "isLocalCooperative": true,
      "isOnlineMultiplayer": false,
      "isOnlineCooperative": false,
      "localMultiplayerMinPlayers": 2,
      "localMultiplayerMaxPlayers": 12,
      "localCooperativeMinPlayers": 2,
      "localCooperativeMaxPlayers": 12,
      "isBroadcastingPrivilegeGranted": true,
      "isCrossPlayEnabled": false,
      "kinectDataForExternal": "Enabled"
    }
  ],
}

I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
Generigenres arrayarray Matrice di una o più delle seguenti stringhe che descrivono i generi del gioco:An array of one or more of the following strings that describe the genres of the game:
  • Games_ActionAndAdventureGames_ActionAndAdventure
  • Games_CardAndBoardGames_CardAndBoard
  • Games_CasinoGames_Casino
  • Games_EducationalGames_Educational
  • Games_FamilyAndKidsGames_FamilyAndKids
  • Games_FightingGames_Fighting
  • Games_MusicGames_Music
  • Games_PlatformerGames_Platformer
  • Games_PuzzleAndTriviaGames_PuzzleAndTrivia
  • Games_RacingAndFlyingGames_RacingAndFlying
  • Games_RolePlayingGames_RolePlaying
  • Games_ShooterGames_Shooter
  • Games_SimulationGames_Simulation
  • Games_SportsGames_Sports
  • Games_StrategyGames_Strategy
  • Games_WordGames_Word
isLocalMultiplayerisLocalMultiplayer booleanboolean Indica se il gioco supporta il multiplayer locale.Indicates whether the game supports local multiplayer.
isLocalCooperativeisLocalCooperative booleanboolean Indica se il gioco supporta la co-op locale.Indicates whether the game supports local co-op.
isOnlineMultiplayerisOnlineMultiplayer booleanboolean Indica se il gioco supporta il multiplayer online.Indicates whether the game supports online multiplayer.
isOnlineCooperativeisOnlineCooperative booleanboolean Indica se il gioco supporta la co-op online.Indicates whether the game supports online co-op.
localMultiplayerMinPlayerslocalMultiplayerMinPlayers INTint Specifica il numero minimo di giocatori supportati dal gioco per il multiplayer locale.Specifies the minimum number of players the game supports for local multiplayer.
localMultiplayerMaxPlayerslocalMultiplayerMaxPlayers INTint Specifica il numero massimo di giocatori supportati dal gioco per il multiplayer locale.Specifies the maximum number of players the game supports for local multiplayer.
localCooperativeMinPlayerslocalCooperativeMinPlayers INTint Specifica il numero minimo di giocatori supportati dal gioco per la co-op locale.Specifies the minimum number of players the game supports for local co-op.
localCooperativeMaxPlayerslocalCooperativeMaxPlayers INTint Specifica il numero massimo di giocatori supportati dal gioco per la co-op locale.Specifies the maximum number of players the game supports for local co-op.
isBroadcastingPrivilegeGrantedisBroadcastingPrivilegeGranted booleanboolean Indica se il gioco supporta la trasmissione.Indicates whether the game supports broadcasting.
isCrossPlayEnabledisCrossPlayEnabled booleanboolean Indica se il gioco supporta le sessioni multiplayer tra i computer Windows 10 e Xbox.Indicates whether the game supports multiplayer sessions between players on Windows 10 PCs and Xbox.
kinectDataForExternalkinectDataForExternal stringstring Uno dei valori stringa seguenti che indica se il gioco può raccogliere dati Kinect e inviarli a servizi esterni:One of the following string values that indicates whether the game can collect Kinect data and send it to external services:
  • NotSetNotSet
  • SconosciutoUnknown
  • AttivatoEnabled
  • DisabledDisabled

Nota

La risorsa gamingOptions è stata aggiunta nel 2017 maggio, dopo che l'API di invio Microsoft Store è stata rilasciata per la prima volta agli sviluppatori.The gamingOptions resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Se è stato creato un invio per un'app tramite l'API di invio prima che questa risorsa venisse introdotta e l'invio è ancora in corso, questa risorsa sarà null per gli invii per l'app fino a quando non si esegue correttamente il commit dell'invio o lo si elimina.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Se la risorsa gamingOptions non è disponibile per gli invii per un'app, il campo hasAdvancedListingPermission della risorsa dell' applicazione restituita dal metodo get an app è false.If the gamingOptions resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Risorsa dettagli sullo statoStatus details resource

Questa risorsa contiene informazioni aggiuntive sullo stato di un invio.This resource contains additional details about the status of a submission. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
errorierrors objectobject Un array di risorse dettagli sullo stato che contiene i dettagli sugli errori per l'invio.An array of status detail resources that contain error details for the submission.
warningswarnings objectobject Un array di risorse dettagli sullo stato che contiene i dettagli sugli avvisi per l'invio.An array of status detail resources that contain warning details for the submission.
certificationReportscertificationReports objectobject Un array di risorse report sulla certificazione che consente di accedere ai dati del report sulla certificazione per l'invio.An array of certification report resources that provide access to the certification report data for the submission. Se la certificazione ha esito negativo, puoi esaminare questi report per altre informazioni.You can examine these reports for more information if the certification fails.

Risorsa dettagli sullo statoStatus detail resource

Questa risorsa contiene informazioni aggiuntive sugli eventuali errori o avvisi correlati per un invio.This resource contains additional information about any related errors or warnings for a submission. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
codicecode stringstring Un codice di stato dell'invio che descrive il tipo di errore o di avviso.A submission status code that describes the type of error or warning.
dettaglidetails stringstring Messaggio con altri dettagli sul problema.A message with more details about the issue.

Risorsa pacchetto di applicazioneApplication package resource

Questa risorsa contiene informazioni dettagliate su un pacchetto di app per l'invio.This resource contains details about an app package for the submission.

{
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "Uploaded",
      "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"
      ]
    }
  ],
}

I valori di questa risorsa sono i seguenti.This resource has the following values.

Nota

Quando si chiama il metodo Update an app Submission , nel corpo della richiesta sono necessari solo i valori filename, fileStatus, minimumDirectXVersione minimumSystemRam di questo oggetto.When calling the update an app submission method, only the fileName, fileStatus, minimumDirectXVersion, and minimumSystemRam values of this object are required in the request body. Gli altri valori vengono popolati dal centro per i partner.The other values are populated by Partner Center.

ValoreValue TipoType DescrizioneDescription
fileNamefileName stringstring Nome del pacchetto.The name of the package.
fileStatusfileStatus stringstring Stato del pacchetto.The status of the package. I valori possibili sono i seguenti:This can be one of the following values:
  • NessunoNone
  • PendingUploadPendingUpload
  • CaricatoUploaded
  • PendingDeletePendingDelete
idid stringstring ID che identifica in modo univoco il pacchetto.An ID that uniquely identifies the package. Questo valore viene fornito dal centro per i partner.This value is provided by Partner Center.
versionversion stringstring Versione del pacchetto dell'app.The version of the app package. Per altre informazioni, vedi Numerazione delle versioni dei pacchetti.For more information, see Package version numbering.
architetturaarchitecture stringstring Architettura del pacchetto, ad esempio ARM.The architecture of the package (for example, ARM).
languageslanguages arrayarray Matrice di codici di lingua per le lingue supportate dell'app.An array of language codes for the languages the app supports. Per altre informazioni, vedere Linguaggi supportati.For more information, see Supported languages.
capabilitiescapabilities arrayarray Matrice di funzionalità richieste per il pacchetto.An array of capabilities required by the package. Per altre informazioni sulle funzionalità, vedi Dichiarazioni di funzionalità delle app.For more information about capabilities, see App capability declarations.
minimumDirectXVersionminimumDirectXVersion stringstring Versione minima di DirectX supportata dal pacchetto dell'app.The minimum DirectX version that is supported by the app package. Questa impostazione può essere configurata solo per le app destinate a Windows 8. x.This can be set only for apps that target Windows 8.x. Per le app destinate ad altre versioni del sistema operativo, questo valore deve essere presente quando si chiama l'aggiornamento di un metodo di invio dell'app , ma il valore specificato viene ignorato.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. I valori possibili sono i seguenti:This can be one of the following values:
  • NessunoNone
  • DirectX93DirectX93
  • DirectX100DirectX100
minimumSystemRamminimumSystemRam stringstring RAM minima richiesta per il pacchetto dell'app.The minimum RAM that is required by the app package. Questa impostazione può essere configurata solo per le app destinate a Windows 8. x.This can be set only for apps that target Windows 8.x. Per le app destinate ad altre versioni del sistema operativo, questo valore deve essere presente quando si chiama l'aggiornamento di un metodo di invio dell'app , ma il valore specificato viene ignorato.For apps that target other OS versions, this value must be present when calling the update an app submission method but the value you specify is ignored. I valori possibili sono i seguenti:This can be one of the following values:
  • NessunoNone
  • Memory2GBMemory2GB
targetDeviceFamiliestargetDeviceFamilies arrayarray Matrice di stringhe che rappresentano le famiglie di dispositivi di destinazione del pacchetto.An array of strings that represent the device families that the package targets. Questo valore viene usato solo per i pacchetti destinati a Windows 10. Per i pacchetti destinati a versioni precedenti, questo valore è None.This value is used only for packages that target Windows 10; for packages that target earlier releases, this value has the value None. Le stringhe di gruppo di dispositivi seguenti sono attualmente supportate per i pacchetti Windows 10, dove {0} è una stringa di versione di Windows 10, ad esempio 10.0.10240.0, 10.0.10586.0 o 10.0.14393.0:The following device family strings are currently supported for Windows 10 packages, where {0} is a Windows 10 version string such as 10.0.10240.0, 10.0.10586.0 or 10.0.14393.0:
  • Windows. versione minima universale {0}Windows.Universal min version {0}
  • Versione minima di Windows. desktop {0}Windows.Desktop min version {0}
  • Versione minima di Windows. mobile {0}Windows.Mobile min version {0}
  • Versione di Windows. Xbox min {0}Windows.Xbox min version {0}
  • Versione minima di Windows. olografica {0}Windows.Holographic min version {0}

Risorsa report sulla certificazioneCertification report resource

Questa risorsa consente di accedere ai dati del report sulla certificazione per un invio.This resource provides access to the certification report data for a submission. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
Datadate stringstring Data e ora in cui è stato generato il report, in formato ISO 8601.The date and time the report was generated, in ISO 8601 format.
reportUrlreportUrl stringstring URL a cui puoi accedere al report.The URL at which you can access the report.

Risorsa opzioni di recapito dei pacchettiPackage delivery options resource

Questa risorsa contiene le impostazioni per l'implementazione graduale del pacchetto e l'aggiornamento obbligatorio per l'invio.This resource contains gradual package rollout and mandatory update settings for the submission.

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}

I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
packageRolloutpackageRollout objectobject Una risorsa implementazione del pacchetto che contiene le impostazioni per l'implementazione graduale del pacchetto per l'invio.A package rollout resource that contains gradual package rollout settings for the submission.
isMandatoryUpdateisMandatoryUpdate booleanboolean Indica se vuoi gestire i pacchetti nell'invio come obbligatori per gli aggiornamenti autoinstallanti dell'app.Indicates whether you want to treat the packages in this submission as mandatory for self-installing app updates. Per altre informazioni sui pacchetti obbligatori per gli aggiornamenti autoinstallanti dell'app, vedi Scaricare e installare gli aggiornamenti di pacchetto per la tua app.For more information about mandatory packages for self-installing app updates, see Download and install package updates for your app.
mandatoryUpdateEffectiveDatemandatoryUpdateEffectiveDate Datadate Data e ora in cui i pacchetti nell'invio diventano obbligatori, in formato ISO 8601 e con il fuso orario UTC.The date and time when the packages in this submission become mandatory, in ISO 8601 format and UTC time zone.

Risorsa implementazione del pacchettoPackage rollout resource

Questa risorsa contiene le impostazioni per l'implementazione graduale del pacchetto per l'invio.This resource contains gradual package rollout settings for the submission. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
isPackageRolloutisPackageRollout booleanboolean Indica se l'implementazione graduale del pacchetto è abilitata per l'invio.Indicates whether gradual package rollout is enabled for the submission.
packageRolloutPercentagepackageRolloutPercentage floatfloat Percentuale di utenti che riceveranno i pacchetti nell'implementazione graduale.The percentage of users who will receive the packages in the gradual rollout.
packageRolloutStatuspackageRolloutStatus stringstring Una delle stringhe seguenti che indica lo stato dell'implementazione graduale del pacchetto:One of the following strings that indicates the status of the gradual package rollout:
  • PackageRolloutNotStartedPackageRolloutNotStarted
  • PackageRolloutInProgressPackageRolloutInProgress
  • PackageRolloutCompletePackageRolloutComplete
  • PackageRolloutStoppedPackageRolloutStopped
fallbackSubmissionIdfallbackSubmissionId stringstring ID dell'invio che verrà ricevuto dai clienti che non ottengono i pacchetti a implementazione graduale.The ID of the submission that will be received by customers who do not get the gradual rollout packages.

Nota

I valori packageRolloutStatus e fallbackSubmissionId vengono assegnati dal centro per i partner e non sono destinati a essere impostati dallo sviluppatore.The packageRolloutStatus and fallbackSubmissionId values are assigned by Partner Center, and are not intended to be set by the developer. Se si includono questi valori nel corpo di una richiesta, questi valori verranno ignorati.If you include these values in a request body, these values will be ignored.

Risorsa trailerTrailers resource

Questa risorsa rappresenta un trailer video per l'elenco delle app.This resource represents a video trailer for the app listing. I valori in questa risorsa corrispondono alle opzioni dei trailer per gli invii nel centro per i partner.The values in this resource correspond to the trailers options for submissions in Partner Center.

È possibile aggiungere fino a 15 risorse trailer alla matrice Trailers in una risorsa di invio dell'app.You can add up to 15 trailer resources to the trailers array in an app submission resource. Per caricare i file video trailer e le immagini di anteprima per un invio, aggiungere questi file allo stesso archivio ZIP che contiene i pacchetti e elencare le immagini per l'invio, quindi caricare l'archivio ZIP nell'URI della firma di accesso condiviso (SAS) per l'invio.To upload trailer video files and thumbnail images for a submission, add these files to the same ZIP archive that contains the packages and listing images for the submission, and then upload this ZIP archive to the shared access signature (SAS) URI for the submission. Per altre informazioni sul caricamento dell'archivio ZIP nell'URI della firma di accesso condiviso, vedere creare un invio di app.For more information uploading the ZIP archive to the SAS URI, see Create an app submission.

{
  "trailers": [
    {
      "id": "1158943556954955699",
      "videoFileName": "Trailers\\ContosoGameTrailer.mp4",
      "videoFileId": "1159761554639123258",
      "trailerAssets": {
        "en-us": {
          "title": "Contoso Game",
          "imageList": [
            {
              "fileName": "Images\\ContosoGame-Thumbnail.png",
              "id": "1155546904097346923",
              "description": "This is a still image from the video."
            }
          ]
        }
      }
    }
  ]
}

I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
idid stringstring ID del trailer.The ID for the trailer. Questo valore viene fornito dal centro per i partner.This value is provided by Partner Center.
videoFileNamevideoFileName stringstring Nome del file video trailer nell'archivio ZIP che contiene i file per l'invio.The name of the trailer video file in the ZIP archive that contains files for the submission.
videoFileIdvideoFileId stringstring ID del file video trailer.The ID for the trailer video file. Questo valore viene fornito dal centro per i partner.This value is provided by Partner Center.
trailerAssetstrailerAssets objectobject Dizionario di coppie chiave-valore, dove ogni chiave è un codice di lingua e ogni valore è una risorsa di asset trailer che contiene risorse aggiuntive specifiche delle impostazioni locali per il trailer.A dictionary of key and value pairs, where each key is a language code and each value is a trailer assets resource that contains additional locale-specific assets for the trailer. Per ulteriori informazioni sui codici di lingua supportati, vedere linguaggi supportati.For more information about the supported language codes, see Supported languages.

Nota

La risorsa trailer è stata aggiunta nel 2017 maggio, dopo che l'API di invio Microsoft Store è stata rilasciata per la prima volta agli sviluppatori.The trailers resource was added in May 2017, after the Microsoft Store submission API was first released to developers. Se è stato creato un invio per un'app tramite l'API di invio prima che questa risorsa venisse introdotta e l'invio è ancora in corso, questa risorsa sarà null per gli invii per l'app fino a quando non si esegue correttamente il commit dell'invio o lo si elimina.If you created a submission for an app via the submission API before this resource was introduced and this submission is still in progress, this resource will be null for submissions for the app until you successfully commit the submission or you delete it. Se la risorsa trailer non è disponibile per gli invii per un'app, il campo hasAdvancedListingPermission della risorsa dell'applicazione restituita dal metodo get an app è false.If the trailers resource is not available for submissions for an app, the hasAdvancedListingPermission field of the Application resource returned by the get an app method is false.

Risorsa risorse trailerTrailer assets resource

Questa risorsa contiene risorse aggiuntive specifiche delle impostazioni locali per un trailer definito in una risorsa trailer.This resource contains additional locale-specific assets for a trailer that is defined in a trailer resource. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
titletitle stringstring Titolo localizzato del trailer.The localized title of the trailer. Il titolo viene visualizzato quando l'utente riproduce il trailer in modalità schermo intero.The title is displayed when the user plays the trailer in full screen mode.
imageListimageList arrayarray Matrice che contiene una risorsa immagine che fornisce l'immagine di anteprima per il trailer.An array that contains one image resource that provides the thumbnail image for the trailer. In questa matrice è possibile includere solo una risorsa immagine .You can only include one image resource in this array.

Risorsa immagine (per un trailer)Image resource (for a trailer)

Questa risorsa descrive l'immagine di anteprima per un trailer.This resource describes the thumbnail image for a trailer. I valori di questa risorsa sono i seguenti.This resource has the following values.

ValoreValue TipoType DescrizioneDescription
fileNamefileName stringstring Nome del file di immagine di anteprima nell'archivio ZIP caricato per l'invio.The name of the thumbnail image file in the ZIP archive that you uploaded for the submission.
idid stringstring ID dell'immagine di anteprima.The ID for the thumbnail image. Questo valore viene fornito dal centro per i partner.This value is provided by Partner Center.
descriptiondescription stringstring Descrizione dell'immagine di anteprima.The description for the thumbnail image. Questo valore è solo metadati e non viene visualizzato agli utenti.This value is metadata only, and is not displayed to users.

EnumerazioniEnums

Questi metodi usano le enumerazioni seguenti.These methods use the following enums.

Livelli di prezzoPrice tiers

I valori seguenti rappresentano i livelli di prezzo disponibili nella risorsa di risorse dei prezzi per l'invio di un'app.The following values represent available price tiers in the pricing resource resource for an app submission.

ValoreValue DescrizioneDescription
BaseBase Non è stato impostato un livello di prezzo. Usa il prezzo di base per l'app.The price tier is not set; use the base price for the app.
NotAvailableNotAvailable L'app non è disponibile nell'area geografica specificata.The app is not available in the specified region.
Livello gratuitoFree L'app è gratuita.The app is free.
LivelloxxxTierxxx Stringa che specifica il livello di prezzo per l'app, nel formato del livelloxxxx.A string that specifies the price tier for the app, in the format Tierxxxx. Attualmente sono supportati i seguenti intervalli di piani tariffari:Currently, the following ranges of price tiers are supported:

  • Se il valore isAdvancedPricingModel della risorsa relativa ai prezzi è true, i valori del livello di prezzo disponibili per l'account sono Tier1012 - Tier1424.If the isAdvancedPricingModel value of the pricing resource is true, the available price tier values for your account are Tier1012 - Tier1424.
  • Se il valore isAdvancedPricingModel della risorsa relativa ai prezzi è false, i valori del livello di prezzo disponibili per l'account sono livello 2 - Tier96.If the isAdvancedPricingModel value of the pricing resource is false, the available price tier values for your account are Tier2 - Tier96.
Per visualizzare la tabella completa dei piani tariffari disponibili per l'account sviluppatore, inclusi i prezzi specifici del mercato associati a ogni livello, passare alla pagina prezzi e disponibilità per gli invii di app nel centro per i partner e fare clic sul collegamento Visualizza tabella nella sezione mercati e prezzi personalizzati . per alcuni account sviluppatore, questo collegamento è disponibile nella sezione relativa ai prezzi.To see the complete table of price tiers that are available for your developer account, including the market-specific prices that are associated with each tier, go to the Pricing and availability page for any of your app submissions in Partner Center and click the view table link in the Markets and custom prices section (for some developer accounts, this link is in the Pricing section).

Valori di licenza EnterpriseEnterprise licensing values

I valori seguenti rappresentano il comportamento di licenza aziendale per l'app.The following values represent the organizational licensing behavior for the app. Per altre informazioni su queste opzioni, vedi Opzioni relative alla gestione delle licenze per le organizzazioni.For more information about these options, see Organizational licensing options.

Nota

Sebbene sia possibile configurare le opzioni di licenza dell'organizzazione per l'invio di un'app tramite l'API di invio, non è possibile usare questa API per pubblicare invii per gli acquisti di volumi tramite il Microsoft Store per le aziende e Microsoft Store per la formazione.Although you can configure the organizational licensing options for an app submission via the submission API, you cannot use this API to publish submissions for volume purchases through the Microsoft Store for Business and Microsoft Store for Education. Per pubblicare invii in Microsoft Store for business e Microsoft Store per la formazione, è necessario usare il centro per i partner.To publish submissions to the Microsoft Store for Business and Microsoft Store for Education, you must use Partner Center.

ValoreValue DescrizioneDescription
nessunoNone L'app non viene resa disponibile per le aziende con contratti multilicenza gestiti dallo Store (online).Do not make your app available to enterprises with Store-managed (online) volume licensing.
OnlineOnline L'app viene resa disponibile per le aziende con contratti multilicenza gestiti dallo Store (online).Make your app available to enterprises with Store-managed (online) volume licensing.
OnlineAndOfflineOnlineAndOffline L'app viene resa disponibile per le aziende con contratti multilicenza gestiti dallo Store (online) e tramite licenze disconnesse (offline).Make your app available to enterprises with Store-managed (online) volume licensing, and make your app available to enterprises via disconnected (offline) licensing.

Codice di stato dell'invioSubmission status code

I valori seguenti rappresentano il codice di stato di un invio.The following values represent the status code of a submission.

ValoreValue DescrizioneDescription
nessunoNone Non è stato specificato alcun codice.No code was specified.
InvalidArchiveInvalidArchive L'archivio ZIP che contiene il pacchetto non è valido o è in un formato non riconosciuto.The ZIP archive containing the package is invalid or has an unrecognized archive format.
MissingFilesMissingFiles L'archivio ZIP non dispone di tutti i file che sono stati elencati nei dati dell'invio o i file si trovano in un percorso errato nell'archivio.The ZIP archive does not have all files which were listed in your submission data, or they are in the wrong location in the archive.
PackageValidationFailedPackageValidationFailed Uno o più pacchetti nell'invio non hanno superato la convalida.One or more packages in your submission failed to validate.
InvalidParameterValueInvalidParameterValue Uno dei parametri nel contenuto della richiesta non è valido.One of the parameters in the request body is invalid.
InvalidOperationInvalidOperation L'operazione che hai tentato di eseguire non è valida.The operation you attempted is invalid.
InvalidStateInvalidState L'operazione che hai tentato di eseguire non è valida per lo stato corrente del pacchetto in anteprima.The operation you attempted is not valid for the current state of the package flight.
ResourceNotFoundResourceNotFound Non è possibile trovare il pacchetto in anteprima specificato.The specified package flight could not be found.
ServiceErrorServiceError Un errore interno del servizio ha impedito il completamento della richiesta.An internal service error prevented the request from succeeding. Riprova a eseguire la richiesta.Try the request again.
ListingOptOutWarningListingOptOutWarning Lo sviluppatore ha rimosso una presentazione da un invio precedente o non ha incluso informazioni sulla presentazione supportate dal pacchetto.The developer removed a listing from a previous submission, or did not include listing information that is supported by the package.
ListingOptInWarningListingOptInWarning Lo sviluppatore ha aggiunto una presentazione.The developer added a listing.
UpdateOnlyWarningUpdateOnlyWarning Lo sviluppatore sta tentando di inserire un elemento che supporta solo l'aggiornamento.The developer is trying to insert something that only has update support.
AltroOther L'invio è in uno stato non riconosciuto o non classificato.The submission is in an unrecognized or uncategorized state.
PackageValidationWarningPackageValidationWarning Il processo di convalida del pacchetto ha generato un avviso.The package validation process resulted in a warning.