Mettre à jour une soumission d’applicationUpdate an app submission

Utilisez cette méthode dans l’API de soumission Microsoft Store pour mettre à jour une soumission d’application existante.Use this method in the Microsoft Store submission API to update an existing app submission. Après avoir mis à jour une soumission à l’aide de cette méthode, vous devez valider la soumission en vue de son intégration et de sa publication.After you successfully update a submission by using this method, you must commit the submission for ingestion and publishing.

Pour plus d’informations sur la façon dont cette méthode s’intègre au processus de création d’une soumission d’application à l’aide de l’API de soumission Microsoft Store, consultez gérer les envois d’applications.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.

PrérequisPrerequisites

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :To use this method, you need to first do the following:

  • Si vous ne l’avez pas déjà fait, renseignez toutes les conditions préalables pour l’API de soumission Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode.Obtain an Azure AD access token to use in the request header for this method. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire.After you obtain an access token, you have 60 minutes to use it before it expires. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.After the token expires, you can obtain a new one.
  • Créez une soumission pour l’une de vos applications.Create a submission for one of your apps. Vous pouvez effectuer cette opération dans l’espace partenaires, ou vous pouvez le faire à l’aide de la méthode créer une soumission d’application .You can do this in Partner Center, or you can do this by using the create an app submission method.

RequêteRequest

Cette méthode présente la syntaxe suivante.This method has the following syntax. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.See the following sections for usage examples and descriptions of the header and request body.

MéthodeMethod URI de demandeRequest URI
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AutorisationAuthorization stringstring Obligatoire.Required. Jeton d’accès Azure AD sous la forme Bearer <jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la demandeRequest parameters

NomName TypeType DescriptionDescription
applicationIdapplicationId stringstring Obligatoire.Required. ID Windows Store de l’application pour laquelle vous voulez mettre à jour une soumission.The Store ID of the app for which you want to update a submission. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Obligatoire.Required. ID de la soumission à mettre à jour.The ID of the submission to update. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’application.This ID is available in the response data for requests to create an app submission. Pour une soumission qui a été créée dans l’espace partenaires, cet ID est également disponible dans l’URL de la page de soumission dans l’espace partenaires.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corps de la demandeRequest body

Le corps de la requête contient les paramètres suivants.The request body has the following parameters.

ValeurValue TypeType DescriptionDescription
applicationCategoryapplicationCategory stringstring Chaîne qui spécifie la catégorie et/ou sous-catégorie pour votre application.A string that specifies the category and/or subcategory for your app. Les catégories et sous-catégories sont combinées en une seule chaîne à l’aide du caractère trait de soulignement « _ », par exemple BooksAndReference_EReader.Categories and subcategories are combined into a single string with the underscore '_' character, such as BooksAndReference_EReader.
Prixpricing objectobject Objet qui contient les informations de tarification pour l’application.An object that contains pricing info for the app. Pour plus d’informations, voir la section relative à la ressource de tarification.For more information, see the Pricing resource section.
visibilityvisibility stringstring Visibilité de l’application.The visibility of the app. Il peut s’agir de l’une des valeurs suivantes :This can be one of the following values:
  • HiddenHidden
  • PublicPublic
  • PrivéesPrivate
  • NotSetNotSet
targetPublishModetargetPublishMode stringstring Mode de publication pour la soumission.The publish mode for the submission. Il peut s’agir de l’une des valeurs suivantes :This can be one of the following values:
  • ImmédiatImmediate
  • ManuelManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate stringstring Date de publication de la soumission au format ISO 8601, si le paramètre targetPublishMode a la valeur SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
listingslistings objectobject Dictionnaire de paires clé/valeur, où chaque clé est un code de pays et chaque valeur est un objet de ressource de référencement qui contient des informations de référencement pour l’application.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 tableauarray Tableau de chaînes qui définissent les préférences matérielles pour votre application.An array of strings that define the hardware preferences for your app. Il peut s’agir de l’une des valeurs suivantes :This can be one of the following values:
  • ToucherTouch
  • ClavierKeyboard
  • SourisMouse
  • Appareil photoCamera
  • NfcHceNfcHce
  • NFCNfc
  • BluetoothLEBluetoothLE
  • TelephonyTelephony
automaticBackupEnabledautomaticBackupEnabled booleanboolean Indique si Windows peut inclure les données de votre application dans les sauvegardes automatiques sur OneDrive.Indicates whether Windows can include your app's data in automatic backups to OneDrive. Pour plus d’informations, voir Déclarations d’application.For more information, see App declarations.
canInstallOnRemovableMediacanInstallOnRemovableMedia booleanboolean Indique si les clients peuvent installer votre application sur un stockage amovible.Indicates whether customers can install your app to removable storage. Pour plus d’informations, voir Déclarations d’application.For more information, see App declarations.
isGameDvrEnabledisGameDvrEnabled booleanboolean Indique si les jeux DVR sont activés pour l’application.Indicates whether game DVR is enabled for the app.
gamingOptionsgamingOptions objectobject Tableau qui contient une ressource d’options de jeu qui définit des paramètres liés aux jeux pour l’application.An array that contains one gaming options resource that defines game-related settings for the app.
hasExternalInAppProductshasExternalInAppProducts booleanboolean Indique si votre application permet aux utilisateurs d’effectuer des achats en dehors du système de commerce Microsoft Store.Indicates whether your app allows users to make purchase outside the Microsoft Store commerce system. Pour plus d’informations, voir Déclarations d’application.For more information, see App declarations.
meetAccessibilityGuidelinesmeetAccessibilityGuidelines booleanboolean Indique si votre application a fait l’objet de tests pour voir si elle est conforme aux recommandations d’accessibilité.Indicates whether your app has been tested to meet accessibility guidelines. Pour plus d’informations, voir Déclarations d’application.For more information, see App declarations.
notesForCertificationnotesForCertification stringstring Contient des notes de certification pour votre application.Contains notes for certification for your app.
applicationPackagesapplicationPackages tableauarray Contient des objets qui fournissent des détails sur chaque package de la soumission.Contains objects that provide details about each package in the submission. Pour plus d’informations, voir la section Package d’application.For more information, see the Application package section. Quand vous appelez cette méthode pour mettre à jour une soumission d’application, seules les valeurs fileName, fileStatus, minimumDirectXVersion et minimumSystemRam de ces objets sont nécessaires dans le corps de la requête.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. Les autres valeurs sont remplies par l’espace partenaires.The other values are populated by Partner Center.
packageDeliveryOptionspackageDeliveryOptions objectobject Contient les paramètres de déploiement de package progressif et de mise à jour obligatoire de la soumission.Contains gradual package rollout and mandatory update settings for the submission. Pour plus d’informations, consultez Objet options de remise du package.For more information, see Package delivery options object.
enterpriseLicensingenterpriseLicensing stringstring Une des valeur de gestion des licences d’entreprise qui indiquent le comportement de la gestion des licences d’entreprise pour l’application.One of the enterprise licensing values values that indicate the enterprise licensing behavior for the app.
allowMicrosftDecideAppAvailabilityToFutureDeviceFamiliesallowMicrosftDecideAppAvailabilityToFutureDeviceFamilies booleanboolean Indique si Microsoft est autorisé à rendre l’application disponible pour les futures familles d’appareils Windows 10.Indicates whether Microsoft is allowed to make the app available to future Windows 10 device families.
allowTargetFutureDeviceFamiliesallowTargetFutureDeviceFamilies booleanboolean Indique si votre application est autorisée à cibler les futures familles d’appareils Windows 10.Indicates whether your app is allowed to target future Windows 10 device families.
codestrailers tableauarray Tableau qui contient jusqu’à ressources de terminaison qui représentent des codes de fin vidéo pour la liste des applications.An array that contains up to trailer resources that represent video trailers for the app listing.

Exemple de requêteRequest example

L’exemple suivant montre comment mettre à jour une soumission d’application.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": []
}

responseResponse

L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode.The following example demonstrates the JSON response body for a successful call to this method. Le corps de la réponse contient des informations sur la soumission mise à jour.The response body contains information about the updated submission. Pour plus d’informations sur les valeurs figurant dans le corps de la réponse, voir la ressource de soumission d’application.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": []
}

Codes d’erreurError codes

Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Code d'erreurError code DescriptionDescription
400400 Impossible de mettre à jour la soumission, car la requête n’est pas valide.The submission could not be updated because the request is invalid.
409409 La soumission n’a pas pu être mise à jour en raison de l’état actuel de l’application, ou l’application utilise une fonctionnalité de l’espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission 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.