Share via

Obtenir des informations de lancement pour une soumission d’application

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour obtenir les informations de lancement du package pour une soumission de version d’évaluation de package. Pour plus d’informations sur le processus de création d’une soumission d’application à l’aide de l’API de soumission du Microsoft Store, consultez Gérer les soumissions d’applications.

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.
  • Créez une soumission pour l’une de vos applications. Vous pouvez le faire dans l’Espace partenaires ou vous pouvez le faire à l’aide de la méthode créer une soumission d’application .

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 des paramètres de la requête.

Méthode URI de demande
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout

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 soumission avec les informations sur le lancement du package que vous voulez récupérer. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.
submissionId string Obligatoire. ID de la soumission avec les informations sur le lancement du package que vous voulez récupérer. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’application. 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.

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 obtenir les informations de lancement du package d’une soumission d’application.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243649/packagerollout HTTP/1.1
Authorization: Bearer <your access token>

response

L’exemple suivant décrit le corps de la réponse JSON pour un appel réussi à cette méthode, pour une soumission d’application avec le lancement progressif du package activé. Pour plus d’informations sur les valeurs figurant dans le corps de la réponse, voir la ressource de lancement du package.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Si la soumission d’application ne présente pas de lancement progressif de package activé, le corps de réponse suivant sera renvoyé.

{
    "isPackageRollout": false,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutNotStarted",
    "fallbackSubmissionId": "0"
}

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
404 La soumission est introuvable.
409 La soumission n’appartient pas à l’application spécifiée, ou l’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission au Microsoft Store.