Obtient une version d’évaluation du packageGet a package flight

Utilisez cette méthode dans l’API de soumission Microsoft Store pour obtenir des données pour un vol de package pour une application inscrite auprès de votre compte espace partenaires.Use this method in the Microsoft Store submission API to get data for a package flight for an app that is registered to your Partner Center account.

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.

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}

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 version d’évaluation du package à obtenir.The Store ID of the app that contains the package flight you want to get. L’ID de magasin de l’application est disponible dans l’espace partenaires.The Store ID for the app is available in Partner Center.
flightIdflightId stringstring Obligatoire.Required. ID de la version d’évaluation du package à obtenir.The ID of the package flight 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.

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 récupérer les informations sur un version d’évaluation du dont l’ID est 43e448df-97c9-4a43-a0bc-2a445e736bcd pour une application dont la valeur de l’IS Windows Store est 9WZDNCRD91MD.The following example demonstrates how to retrieve information about a package flight with the ID 43e448df-97c9-4a43-a0bc-2a445e736bcd for an app with the Store ID value 9WZDNCRD91MD.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd 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. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir les sections suivantes.For more details about the values in the response body, see the following sections.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Response bodyResponse body

ValeurValue TypeType DescriptionDescription
flightIdflightId stringstring ID de la version d’évaluation du package.The ID for the package flight. Cette valeur est fournie par l’espace partenaires.This value is supplied by Partner Center.
friendlyNamefriendlyName stringstring Nom de la version d’évaluation du package, tel que spécifié par le développeur.The name of the package flight, as specified by the developer.
lastPublishedFlightSubmissionlastPublishedFlightSubmission objectobject Objet qui fournit des informations sur la dernière soumission publiée de la version d’évaluation du package.An object that provides information about the last published submission for the package flight. Pour plus d’informations, voir la section Objet de la soumission ci-dessous.For more information, see the Submission object section below.
pendingFlightSubmissionpendingFlightSubmission objectobject Objet qui fournit des informations sur la soumission actuellement en attente pour la version d’évaluation du package.An object that provides information about the current pending submission for the package flight. Pour plus d’informations, voir la section Objet de la soumission ci-dessous.For more information, see the Submission object section below.
groupIdsgroupIds tableauarray Tableau de chaînes qui contiennent les ID des groupes de versions d’évaluation associés à la version d’évaluation du package.An array of strings that contain the IDs of the flight groups that are associated with the package flight. Pour plus d’informations sur les groupes de versions d’évaluation, voir Versions d’évaluation du package.For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan stringstring Nom convivial de la version d’évaluation du package classée juste en dessous de la version d’évaluation du package actuelle.The friendly name of the package flight that is ranked immediately lower than the current package flight. Pour plus d’informations sur le classement des groupes de versions d’évaluation, voir Versions d’évaluation de package.For more information about ranking flight groups, see Package flights.

Objet de la soumissionSubmission object

Les valeurs lastPublishedFlightSubmission et pendingFlightSubmission dans le corps de la réponse contiennent des objets qui fournissent des informations sur les ressources d’une soumission de version d’évaluation du package.The lastPublishedFlightSubmission and pendingFlightSubmission values in the response body contain objects that provide resource information about a submission for the package flight. Ces objets ont les valeurs suivantes.These objects have the following values.

ValeurValue TypeType DescriptionDescription
idid stringstring ID de la soumission.The ID of the submission.
resourceLocationresourceLocation stringstring Chemin relatif à ajouter à l’URI de requête https://manage.devcenter.microsoft.com/v1.0/my/ de base pour récupérer les données complètes de la soumission.A relative path that you can append to the base https://manage.devcenter.microsoft.com/v1.0/my/ request URI to retrieve the complete data for the submission.

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 La requête n’est pas valide.The request is invalid.
404404 La version d’évaluation du package spécifiée est introuvable.The specified package flight could not be found.
409409 L’application utilise une fonctionnalité d’espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission Microsoft Store.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.