Obtient une version d’évaluation du package
Utilisez cette méthode dans l’API de soumission du Microsoft Store pour obtenir des données pour une version d’évaluation de package pour une application inscrite dans votre compte Espace partenaires.
Prérequis
Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :
- Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API de soumission du Microsoft Store.
- Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode. 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. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.
Requête
Cette méthode présente la syntaxe suivante. 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.
Méthode | URI de demande |
---|---|
GET | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId} |
En-tête de requête
En-tête | Type | Description |
---|---|---|
Autorisation | string | Obligatoire. Jeton d’accès Azure AD sous la formeJeton> du porteur<. |
Paramètres de la demande
Nom | Type | Description |
---|---|---|
applicationId | string | Obligatoire. ID Windows Store de l’application qui contient la version d’évaluation du package à obtenir. L’ID Store de l’application est disponible dans l’Espace partenaires. |
flightId | string | Obligatoire. ID de la version d’évaluation du package à obtenir. Cet ID est disponible dans les données de réponse pour les demandes de création d’une version d’évaluation de package et d’obtention de versions d’évaluation de package pour une application. Pour une version d’évaluation créée dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page d’évaluation de l’Espace partenaires. |
Corps de la demande
Ne fournissez pas de corps de requête pour cette méthode.
Exemple de requête
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.
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>
response
L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode. Pour plus d’informations sur les valeurs figurant dans le corps de réponse, voir les sections suivantes.
{
"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 body
Valeur | Type | Description |
---|---|---|
flightId | string | ID de la version d’évaluation du package. Cette valeur est fournie par l’Espace partenaires. |
friendlyName | string | Nom de la version d’évaluation du package, tel que spécifié par le développeur. |
lastPublishedFlightSubmission | object | Objet qui fournit des informations sur la dernière soumission publiée de la version d’évaluation du package. Pour plus d’informations, voir la section Objet de la soumission ci-dessous. |
pendingFlightSubmission | object | Objet qui fournit des informations sur la soumission actuellement en attente pour la version d’évaluation du package. Pour plus d’informations, voir la section Objet de la soumission ci-dessous. |
groupIds | tableau | Tableau de chaînes qui contiennent les ID des groupes de versions d’évaluation associés à la version d’évaluation du package. Pour plus d’informations sur les groupes de versions d’évaluation, voir Versions d’évaluation du package. |
rankHigherThan | string | Nom convivial de la version d’évaluation du package classée juste en dessous de la version d’évaluation du package actuelle. Pour plus d’informations sur le classement des groupes de versions d’évaluation, voir Versions d’évaluation de package. |
Objet de la soumission
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. Ces objets ont les valeurs suivantes.
Valeur | Type | Description |
---|---|---|
id | string | ID de la soumission. |
resourceLocation | string | 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. |
Codes d’erreur
Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.
Code d'erreur | Description |
---|---|
400 | La requête n’est pas valide. |
404 | La version d’évaluation du package spécifiée est introuvable. |
409 | L’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission du Microsoft Store. |
Rubriques connexes
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour