Obtenir des données d’application

  • Article

Utilisez les méthodes suivantes dans l’API de soumission du Microsoft Store pour obtenir des données pour les applications existantes dans votre compte espace partenaires. Pour une présentation de l’API de soumission au Microsoft Store, y compris les conditions préalables à l’utilisation de l’API, consultez Créer et gérer des soumissions à l’aide des services du Microsoft Store.

Avant de pouvoir utiliser ces méthodes, l’application doit déjà exister dans votre compte Espace partenaires. Pour créer ou gérer des soumissions pour des applications, voir les méthodes dans Gérer les soumissions d’applications.

Méthode URI Description
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Obtenir des données pour toutes vos applications
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obtenir des données pour une application spécifique
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Obtenir des extensions pour une application
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obtenir des versions d’évaluation du package pour une application

Prérequis

Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API de soumission au Microsoft Store avant d’essayer d’utiliser l’une de ces méthodes.

Ressources de données

Les méthodes d’API de soumission du Microsoft Store pour obtenir des données d’application utilisent les ressources de données JSON suivantes.

Ressource d'application

Cette ressource représente une application inscrite dans votre compte.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
id string ID Windows Store de l’application. Pour plus d’informations sur l’ID Windows Store, voir Visualiser les informations d’identité des applications.
primaryName string Nom principal de l’application.
packageFamilyName string Nom de la famille de packages de l’application.
packageIdentityName string Nom de l’identité du package de l’application.
publisherName string ID de l’éditeur Windows associé à l’application. Cela correspond à la valeur Package/Identity/Publisher qui s’affiche sur la page Identité de l’application pour l’application dans l’Espace partenaires.
firstPublishedDate string Date de la première publication de l’application, au format ISO 8601.
lastPublishedApplicationSubmission object Ressource de soumission qui fournit des informations sur la dernière soumission publiée de l’application.
pendingApplicationSubmission object Ressource de soumission qui fournit des informations sur la soumission actuellement en attente pour l’application.
hasAdvancedListingPermission boolean Indique si vous pouvez configurer les options de jeu ou lesbandes-annonces pour les soumissions pour l’application. Cette valeur est vraie pour les soumissions créées après mai 2017.

Ressource d’extension

Cette ressource fournit des informations sur une extension.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
inAppProductId string ID Windows Store de l’extension. Cette valeur est fournie par le Windows Store. Exemple d’ID Windows Store : 9NBLGGH4TNMP.

Ressource de version d’évaluation du package

Cette ressource fournit des informations sur une version d’évaluation du package pour une application.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Cette ressource a les valeurs suivantes.

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é par le développeur.
lastPublishedFlightSubmission object Ressource de soumission qui fournit des informations sur la dernière soumission publiée de la version d’évaluation du package.
pendingFlightSubmission object Ressource de soumission qui fournit des informations sur la soumission actuellement en attente pour la version d’évaluation du package.
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, voir Versions d’évaluation du package.
rankHigherThan string Nom convivial de la version d’évaluation du package classée juste en dessous de la version d’évaluation du package actuelle. Pour plus d’informations sur le classement des groupes de versions d’évaluation, voir Versions d’évaluation de package.

Ressource de soumission

Cette ressource fournit des informations sur une soumission. L’exemple suivant illustre le format de cette ressource.

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
id string ID de la soumission.
resourceLocation string Chemin relatif à ajouter à l’URI de requête https://manage.devcenter.microsoft.com/v1.0/my/ de base pour récupérer les données complètes de la soumission.