Obtenir des informations de déploiement pour une soumission d’application

2025-06-10

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

Conditions préalables

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables 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 pour 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 expiré, 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 en utilisant la méthode pour créer une soumission d'application.

Requête

Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions des paramètres d’en-tête et de requête.

Méthode	URI de la requête
OBTENIR	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/packagerollout`

En-tête de requête

En-tête de page	Catégorie	Descriptif
Autorisation	ficelle	Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Nom	Catégorie	Descriptif
applicationId	ficelle	Obligatoire. ID Store de l’application qui contient la soumission avec les informations de déploiement du package que vous souhaitez obtenir. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.
ID de soumission	ficelle	Obligatoire. ID de la soumission avec les informations de déploiement du package que vous souhaitez obtenir. 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 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 requête

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 déploiement de package pour 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>

Réponse

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

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

Si la soumission de l’application n’a pas de déploiement progressif du package activé, le corps de réponse suivant est retourné.

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

Codes d’erreur

Si la requête ne peut pas être terminée, la réponse contient l’un des codes d’erreur HTTP suivants.

Code d’erreur	Descriptif
404	Impossible de trouver la soumission.
409	La soumission n’appartient pas à l’application spécifiée, ou l’application utilise une fonctionnalité espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission du Microsoft Store.