Partager via

Obtenir les avis sur les applications

Utilisez cette méthode dans l’API d’analytique du Microsoft Store pour obtenir des données de révision au format JSON pour une plage de dates donnée et d’autres filtres facultatifs. Ces informations sont également disponibles dans le rapport d'avis dans l'Espace partenaires.

Après avoir récupéré des avis, vous pouvez utiliser les informations de réponse pour les avis d’application et soumettre des réponses aux avis d'application dans l’API des avis du Microsoft Store pour répondre automatiquement aux avis.

Conditions préalables

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API d’analytique du Microsoft Store.
  • Obtenez 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

Syntaxe de la requête

Méthode URI de la requête
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Jeton d’accès Azure AD au format Porteur<jeton>.

Paramètres de la demande

Paramètre Catégorie Descriptif Obligatoire
applicationId ficelle L'identifiant de store de l'application pour laquelle vous souhaitez récupérer les données d'avis. Oui
date de début date Date de début dans la plage de dates des données de révision à récupérer. La valeur par défaut est la date actuelle. Non
date de fin date Date de fin dans la plage de dates des données de révision à récupérer. La valeur par défaut est la date actuelle. Non
Haut de page Int Nombre de lignes de données à retourner dans la requête. La valeur maximale et la valeur par défaut si elle n’est pas spécifiée est 1 0000. S’il existe plus de lignes dans la requête, le corps de la réponse inclut un lien suivant que vous pouvez utiliser pour demander la page suivante de données. Non
passer Int Nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir des jeux de données volumineux. Par exemple, top=10000 et skip=0 récupère les 1 000 premières lignes de données, top=10000 et skip=10000 récupère les 1 0000 lignes de données suivantes, et ainsi de suite. Non
Filter ficelle Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Pour plus d’informations, consultez la section des champs de filtre ci-dessous. Non
classer par ficelle Une instruction qui ordonne les valeurs des données de résultat. La syntaxe est orderby=field [order],field [order],.... Le paramètre de champ peut être l’une des chaînes suivantes :
  • date
  • osVersion
  • marché
  • type d'appareil
  • estRévisé
  • versionDuPaquet
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitre
  • reviewText
  • utileCount
  • notHelpful Count
  • responseDate
  • responseText
  • Mémoire RAM de l'appareil
  • deviceStorageCapacity
  • évaluation

Le paramètre d’ordre est facultatif et peut être asc ou desc pour spécifier l’ordre croissant ou décroissant pour chaque champ. La valeur par défaut est asc.

Voici un exemple de chaîne orderby : orderby=date,market

 Non

Champs de filtre

Le filtre paramètre de la requête contient une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un champ et une valeur associés aux opérateurs eq ou ne , et certains champs prennent également en charge les opérateurs contains, gt, lt, ge et le . Les instructions peuvent être combinées à l’aide de et ou ou.

Voici un exemple de chaîne de filtre : filter=contains(reviewText,’great’) and contains(reviewText,’ads’) and deviceRAM lt 2048 and market eq ’US’

Pour obtenir la liste des champs pris en charge et des opérateurs de support pour chaque champ, consultez le tableau suivant. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre .

Domaines Opérateurs pris en charge Descriptif
marché eq, ne Chaîne qui contient le code pays ISO 3166 du marché de l’appareil.
osVersion eq, ne Une des chaînes suivantes :
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Inconnu
type de dispositif eq, ne Une des chaînes suivantes :
  • PC
  • Téléphone
  • Console-Xbox Un
  • Console-Xbox Série X
  • IdO
  • Holographique
  • Inconnu
estRévisé eq, ne Spécifiez true pour filtrer les révisions qui ont été révisées ; sinon false.
version du paquet eq, ne Version du package d’application qui a été examiné.
modèle d'appareil eq, ne Type d’appareil sur lequel l’application a été examinée.
famille de produits eq, ne Une des chaînes suivantes :
  • PC
  • Tablette
  • Téléphone
  • Portable
  • Serveur
  • collaborative
  • Autre
mémoire RAM du périphérique eq, ne, gt, lt, ge, le Ram physique, en Mo.
résolutionÉcranAppareil eq, ne Résolution de l’écran de l’appareil au format « largeur x hauteur ».
capacité de stockage de l'appareil eq, ne, gt, lt, ge, le Capacité du disque de stockage principal, en Go.
estTactileActivé eq, ne Spécifiez true pour filtrer les appareils tactiles ; sinon false.
reviewerName eq, ne Nom du réviseur.
évaluation eq, ne, gt, lt, ge, le Évaluation de l’application, en étoiles.
Titre de la critique eq, ne, contient Titre de la critique.
Texte de critique eq, ne, contient Contenu du texte de la révision.
nombre d'utiles eq, ne Nombre de fois où l’avis a été marqué utile.
nombrePasUtile eq, ne Nombre de fois où la révision a été marquée comme non utile.
date de réponse eq, ne Date à laquelle la réponse a été envoyée.
texteDeRéponse eq, ne, contient Contenu du texte de la réponse.
pièce d'identité eq, ne L'identifiant de la révision (c'est un GUID).

Exemple de requête

Les exemples suivants illustrent plusieurs demandes d’obtention de données de révision. Remplacez la valeur applicationId par l’ID store de votre application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=contains(reviewText,'great') and contains(reviewText,'ads') and deviceRAM lt 2048 and market eq 'US' HTTP/1.1
Authorization: Bearer <your access token>

Réponse

Corps de réponse

Valeur Catégorie Descriptif
Valeur tableau Tableau d'objets qui contiennent des données d'évaluation. Pour plus d’informations sur les données de chaque objet, consultez la section des valeurs de révision ci-dessous.
@nextLink ficelle S’il existe des pages de données supplémentaires, cette chaîne contient un URI que vous pouvez utiliser pour demander la page suivante des données. Par exemple, cette valeur est retournée si le paramètre supérieur de la requête est défini sur 1 0000, mais qu’il existe plus de 1 0000 lignes de données de révision pour la requête.
NombreTotal Int Nombre total de lignes dans le résultat des données de la requête.

 

Passer en revue les valeurs

Les éléments du tableau Value contiennent les valeurs suivantes.

Valeur Catégorie Descriptif
date ficelle La première date de la plage de dates pour les données de révision. Si la demande a spécifié un jour unique, cette valeur est cette date. Si la demande a spécifié une semaine, un mois ou une autre plage de dates, cette valeur est la première date de cette plage de dates.
applicationId ficelle ID Store de l’application pour laquelle vous récupérez des données de révision.
Nom de l'application ficelle Nom d'affichage de l'application.
marché ficelle Code pays ISO 3166 du marché où l’examen a été soumis.
osVersion ficelle Version du système d’exploitation sur laquelle la révision a été envoyée. Pour obtenir la liste des chaînes prises en charge, consultez la section des champs de filtre ci-dessus.
type de dispositif ficelle Type d’appareil sur lequel la révision a été soumise. Pour obtenir la liste des chaînes prises en charge, consultez la section des champs de filtre ci-dessus.
estRévisé Booléen La valeur true indique que la révision a été révisée ; sinon false.
version du paquet ficelle Version du package d’application qui a été examiné.
modèle d'appareil ficelle Type d’appareil sur lequel l’application a été examinée.
famille de produits ficelle Nom de la famille d’appareils. Pour obtenir la liste des chaînes prises en charge, consultez la section des champs de filtre ci-dessus.
mémoire RAM du périphérique nombre Ram physique, en Mo.
résolutionÉcranAppareil ficelle Résolution de l’écran de l’appareil au format « largeur x hauteur ».
capacité de stockage de l'appareil nombre Capacité du disque de stockage principal, en Go.
estTactileActivé Booléen La valeur true indique que l’interaction tactile est activée ; sinon false.
reviewerName ficelle Nom du réviseur.
évaluation nombre Évaluation de l’application, en étoiles.
Titre de la critique ficelle Titre de la critique.
Texte de critique ficelle Contenu du texte de la révision.
nombre d'utiles nombre Nombre de fois où l’avis a été marqué utile.
nombrePasUtile nombre Nombre de fois où la révision a été marquée comme non utile.
date de réponse ficelle Date à laquelle une réponse a été envoyée.
texteDeRéponse ficelle Contenu du texte de la réponse.
pièce d'identité ficelle L'identifiant de la révision (c'est un GUID). Vous pouvez utiliser cet ID dans les méthodes Obtenir des informations de réponse pour les révisions d’application et Envoyer des réponses aux révisions d’application.

Exemple de demande et de réponse

Les extraits de code suivants illustrent un exemple de corps de requête et de réponse JSON pour cette requête.

Exemple de requête

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews?applicationId=9WZDNCRFJB4P&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Exemple de réponse

{
    "Value": [
        {
            "date": "3/5/2021 12:48:33 PM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "ES",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "Jose Antonio",
            "rating": 5,
            "reviewTitle": "Contoso Demo",
            "reviewText": "Un juego fantastico",
            "helpfulCount": 3,
            "notHelpfulCount": 0,
            "id": "b5e27de9-2334-4849-d17d-4eae3e1e7aa9"
        },
        {
            "date": "1/6/2021 8:41:42 AM",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "market": "TR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "isRevised": false,
            "packageVersion": "2.5.2.34894",
            "reviewerName": "fef",
            "rating": 5,
            "helpfulCount": 0,
            "notHelpfulCount": 0,
            "id": "f5d2510a-9796-45ee-01e5-6d5cc4550b09"
        }
    ],
    "TotalCount": 2
}