Mettre à jour le pourcentage de lancement d’une soumission d’application

Utilisez cette méthode dans l’API de soumission au Microsoft Store pour mettre à jour le pourcentage de déploiement d’une soumission d’application. 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.

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 au 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 .
• Autorisez un lancement de package progressif pour la soumission. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de l’API de soumission au Microsoft Store.

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
POST	https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/updatepackagerolloutpercentage

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 le pourcentage de déploiement du package que vous voulez mettre à jour. 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 le pourcentage de déploiement du package que vous voulez mettre à jour. 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.
percentage	float	Obligatoire. Le pourcentage d’utilisateurs qui recevront le package de déploiement progressif.

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 mettre à jour le pourcentage de déploiement du package d’une soumission d’application.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 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 la réponse, voir la ressource de lancement du package.

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

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	Ce code indique l’une des erreurs suivantes : La soumission n’est pas dans un état valide pour l’opération de lancement progressif (avant d’appeler cette méthode, la soumission doit être publiée et la valeur packageRolloutStatus doit être définie sur PackageRolloutInProgress). La soumission n’appartient pas à l’application spécifiée. 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.

Rubriques connexes

• Lancement de package progressif
• Gérer les soumissions d’applications à l’aide de l’API de soumission au Microsoft Store
• Créer et gérer des soumissions à l’aide des services du Microsoft Store