Obtenir des données d’application

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 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.

Méthode URI Descriptif
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/applications Obtenir des données pour toutes vos applications
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Obtenir des données pour une application spécifique
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Obtenir des modules complémentaires pour une application
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Obtenir des packages de vol pour une application

Conditions préalables

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 Catégorie Descriptif
pièce d'identité ficelle ID Store de l’application. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.
nom principal ficelle Nom principal de l’application.
packageFamilyName ficelle Nom de la famille de packages de l’application.
packageIdentityName ficelle Nom de l’identité du package de l’application.
Nom de l'éditeur ficelle ID d’éditeur Windows associé à l’application. Cela correspond à la valeur package/identité/éditeur qui s’affiche sur la page identité de l’application pour l’application dans l’Espace partenaires.
datePremièrePublication ficelle Date de publication de l’application au format ISO 8601.
dernière soumission publiée de l'application objet Ressource de soumission qui fournit des informations sur la dernière soumission publiée pour l’application.
soumission de candidature en attente objet Ressource de soumission qui fournit des informations sur la soumission en attente actuelle pour l’application.
autorisationPublicationAvancée booléen Indique si vous pouvez configurer les options de jeu ou les bandes-annonces pour les propositions d'application. Cette valeur est vraie pour les soumissions créées après mai 2017.

Ressource additionnelle

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

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Cette ressource a les valeurs suivantes.

Valeur Catégorie Descriptif
inAppProductId ficelle L'identifiant de la boutique du module complémentaire. Cette valeur est fournie par le Windows Store. Un exemple d’ID de magasin est 9NBLGGH4TNMP.

Ressource de vol

Cette ressource fournit des informations sur un ensemble de packages 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 Catégorie Descriptif
flightId ficelle Identifiant pour le vol du package. Cette valeur est fournie par l’Espace partenaires.
nom convivial ficelle Nom du vol du package, tel que spécifié par le développeur.
dernièreSoumissionDeVolPubliée objet Ressource de soumission qui fournit des informations sur la dernière soumission publiée pour le vol de paquet.
pendingFlightSubmission objet Une ressource de soumission qui fournit des informations sur la soumission actuellement en attente pour le vol de package.
identifiants de groupe tableau Tableau de chaînes contenant les ID des groupes de vol associés au vol du package. Pour plus d’informations sur les groupes de vols, consultez vols de package.
rangPlusHautQue ficelle Nom d'usage du package de vol qui est classé immédiatement plus bas que le package de vol actuel. Pour plus d'informations sur le classement des groupes de vols, consultez Vols 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 Catégorie Descriptif
pièce d'identité ficelle Identifiant de la soumission.
emplacement de la ressource ficelle 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.

 

  • Last updated on