Partager via

Mettre à jour le pourcentage de lancement pour une soumission de version d’évaluation

  • Article

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

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 toutes les conditions préalables pour l’API de soumission au Microsoft Store.
  • Obtenir 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 à l’aide de la méthode de création d’une soumission d’application.
  • Activez le déploiement progressif d’un package pour la soumission. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de l’API de soumission du Microsoft Store.

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

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>.

Paramètres de la demande

Nom Type Description
applicationId string Obligatoire. ID Store de l’application qui contient la soumission de version d’évaluation du package avec le pourcentage de déploiement de package que vous souhaitez mettre à jour. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.
flightId string Obligatoire. ID de la version d’évaluation du package qui contient la soumission avec le pourcentage de déploiement du package que vous souhaitez mettre à jour. 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 obtenir des 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 de version d’évaluation dans l’Espace partenaires.
submissionId string Obligatoire. ID de la soumission avec le pourcentage de déploiement du package que vous souhaitez mettre à jour. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission de version d’évaluation de package. 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.
pourcentage virgule flottante Obligatoire. 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 de package pour une soumission de version d’évaluation du package.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 HTTP/1.1
Authorization: Bearer <your access token>

Response

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

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

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 Description
404 Impossible de trouver la soumission de version d’évaluation du package.
409 Ce code indique l’une des erreurs suivantes :

  • La soumission n’est pas dans un état valide pour l’opération de déploiement 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.