Obtenir une soumission de version d’évaluation du packageGet a package flight submission

Utilisez cette méthode dans l’API de soumission Microsoft Store pour obtenir des données pour une soumission de vol de packages existante.Use this method in the Microsoft Store submission API to get data for an existing package flight submission. Pour plus d’informations sur le 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 the process of 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éer une soumission de vol de packages pour une application dans l’espace partenaires.Create a package flight submission for an app in Partner Center. 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
GETGET 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 qui contient la soumission de version d’évaluation du package à obtenir.The Store ID of the app that contains the package flight submission you want to get. 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 du package qui contient la soumission à obtenir.The ID of the package flight that contains the submission you want to get. 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 à obtenir.The ID of the submission to get. 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

Ne fournissez pas de corps de requête pour cette méthode.Do not provide a request body for this method.

Exemple de requêteRequest example

L’exemple suivant montre comment obtenir une soumission de version d’évaluation du package pour une application dont l’ID Windows Store est 9WZDNCRD91MD.The following example demonstrates how to get a package flight submission for an app that has the Store ID 9WZDNCRD91MD.

POST 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>

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 spécifiée.The response body contains information about the specified 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
404404 La soumission de version d’évaluation du package est introuvable.The package flight submission could not be found.
409409 L’envoi de vols de packages n’appartient pas au vol de package spécifié, 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 does not belong to the specified package flight, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.