Partager via

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 du 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 les applications, consultez les méthodes de gestion des soumissions d’applications.

Method 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 modules complémentaires pour une application
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obtenir des versions d’évaluation de package pour une application

Prérequis

Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de soumission du 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 Store de l’application. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.
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 d’é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 publication de l’application au format ISO 8601.
lastPublishedApplicationSubmission object Ressource de soumission qui fournit des informations sur la dernière soumission publiée pour l’application.
pendingApplicationSubmission object Ressource de soumission qui fournit des informations sur la soumission en attente actuelle pour l’application.
hasAdvancedListingPermission booléen Indique si vous pouvez configurer les jeuxOptions ou les bandes-annonces pour les soumissions de l’application. Cette valeur est vraie pour les soumissions créées après mai 2017.

Ressource de module complémentaire

Cette ressource fournit des informations sur un module complémentaire.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Cette ressource a les valeurs suivantes.

Valeur Type Description
inAppProductId string ID store du module complémentaire. Cette valeur est fournie par le Windows Store. Un exemple d’ID store est 9NBLGGH4TNMP.

Ressource de vol

Cette ressource fournit des informations sur une version d’évaluation de 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 pour la version d’évaluation du package.
pendingFlightSubmission object Ressource de soumission qui fournit des informations sur la soumission en attente actuelle 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, consultez Packages flight flight.
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. Pour plus d’informations sur le classement des groupes de versions d’évaluation, consultez Versions d’évaluation du 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 L’ID de la soumission.
resourceLocation string Chemin d’accès relatif que vous pouvez ajouter à l’URI de demande de base https://manage.devcenter.microsoft.com/v1.0/my/ pour récupérer les données complètes de la soumission.