Partager via

Crée une version d’évaluation du package

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour créer une version d’évaluation de package pour une application inscrite dans votre compte Espace partenaires.

Remarque

Cette méthode crée une version d’évaluation de package sans soumission. Pour créer une soumission pour la version d’évaluation du package, consultez les méthodes de gestion des soumissions de version d’évaluation de 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.

Requête

Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions du corps de l’en-tête et de la demande.

Méthode URI de demande
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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 pour laquelle vous souhaitez créer une version d’évaluation de package. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.

Corps de la demande

Le corps de la requête a les paramètres suivants.

Paramètre Type Description Obligatoire
friendlyName string Nom de la version d’évaluation du package, tel que spécifié par le développeur. Non
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, consultez Packages flight flight. Non
rankHigherThan string Nom convivial de la version d’évaluation du package classée immédiatement plus bas que la version d’évaluation actuelle du package. Si vous ne définissez pas ce paramètre, la nouvelle version d’évaluation du package aura le rang le plus élevé de toutes les versions d’évaluation du package. Pour plus d’informations sur le classement des groupes de versions d’évaluation, consultez Versions d’évaluation du package. Non

Exemple de requête

L’exemple suivant montre comment créer une version d’évaluation de package pour une application qui a l’ID Store 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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 les sections suivantes.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "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é dans la demande.
groupIds tableau Tableau de chaînes qui contiennent les ID des groupes de versions d’évaluation associés à la version d’évaluation du package, comme spécifié dans la requête. Pour plus d’informations sur les groupes de versions d’évaluation, consultez Packages flight flight.
rankHigherThan string Nom convivial de la version d’évaluation du package qui est classé immédiatement plus bas que la version d’évaluation du package actuelle, comme spécifié dans la demande. Pour plus d’informations sur le classement des groupes de versions d’évaluation, consultez Versions d’évaluation du package.

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
400 La requête n’est pas valide.
409 La version d’évaluation du package n’a pas pu être créée en raison de son état actuel, ou 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.