Mettre à jour une soumission de version d’évaluation de packageUpdate a package flight submission

Utilisez cette méthode dans l’API de soumission Microsoft Store pour mettre à jour une soumission de vol de package existante.Use this method in the Microsoft Store submission API to update an existing package flight 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 de vol de packages à l’aide de l’API de soumission Microsoft Store, consultez gérer les envois de vols de packages.For more information about how this method fits into the process of creating a package flight submission by using the Microsoft Store submission API, see Manage package flight 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 de vol de package pour l’une de vos applications.Create a package flight 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 de vol de package .You can do this in Partner Center, or you can do this by using the create a package flight 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}/flights/{flightId}/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 de version d’évaluation de package.The Store ID of the app for which you want to update a package flight 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.
flightIdflightId stringstring Obligatoire.Required. ID de la version d’évaluation de package pour laquelle vous voulez mettre à jour une soumission.The ID of the package flight for which you want to update a submission. Cet ID est disponible dans les données de réponse pour les demandes de création d’un vol de packages et l' extraction des vols de packages pour une application.This ID is available in the response data for requests to create a package flight and get package flights for an app. Pour un vol créé dans l’espace partenaires, cet ID est également disponible dans l’URL de la page de vol de l’espace partenaires.For a flight that was created in Partner Center, this ID is also available in the URL for the flight page in Partner Center.
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 de vol de packages.This ID is available in the response data for requests to create a package flight 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
flightPackagesflightPackages 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 sur les valeurs figurant dans le corps de la réponse, voir la ressource de package de version d’évaluation.For more details about the values in the response body, see Flight package resource. 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.
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.
notesForCertificationnotesForCertification stringstring Fournit des informations supplémentaires aux testeurs de certification, telles que les informations d’identification du compte de test et les étapes permettant d’accéder aux fonctionnalités et de les vérifier.Provides additional info for the certification testers, such as test account credentials and steps to access and verify features. Pour plus d’informations, voir Notes de certification.For more information, see Notes for certification.

Exemple de requêteRequest example

L’exemple suivant montre comment mettre à jour une soumission de version d’évaluation de package pour une application.The following example demonstrates how to update a package flight submission for an app.

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

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 de version d’évaluation du package.For more details about the values in the response body, see Package flight submission resource.

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

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 de version d’évaluation de package, car la requête n’est pas valide.The package flight submission could not be updated because the request is invalid.
409409 Impossible de mettre à jour l’envoi de vols de packages en raison de l’état actuel de l’application, ou l’application utilise une fonctionnalité d’espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission Microsoft Store.The package flight 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.