Obtenir les avis sur les applications

  • Article

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 Révisions dans l’Espace partenaires.

Après avoir récupéré des révisions, vous pouvez utiliser les informations de réponse pour les révisions d’application et envoyer des réponses aux méthodes d’examen d’application dans l’API révisions du Microsoft Store pour répondre par programmation aux révisions.

Prérequis

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

  • Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse de la Boutique Microsoft.
  • 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

Syntaxe de la requête

Méthode URI de demande
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/reviews

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

Paramètre Type Description Obligatoire
applicationId string ID Store de l’application pour laquelle vous souhaitez récupérer les données de révision. Oui
startDate 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
endDate 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 int Nombre de lignes de données à retourner dans la requête. La valeur maximale, soit la valeur par défaut, est 10000 (si cette valeur n’est pas spécifiée). 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
skip 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 10000 premières lignes de données, top=10000 et skip=10000 récupère les 10000 lignes de données suivantes, et ainsi de suite. Non
filter string Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Pour plus d’informations, consultez la section Champs de filtreci-dessous. Non
orderby string Instruction qui commande les valeurs de 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
  • market
  • deviceType
  • isRevised
  • packageVersion
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitle
  • reviewText
  • utileCount
  • notHelpfulCount
  • responseDate
  • responseText
  • deviceRAM
  • deviceStorageCapacity
  • rating

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 Filtrer

Le paramètre de filtre 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 et ou.

Voici un exemple de chaîne de filtre : filter=contains(reviewText,'great') et contains(reviewText,'ads') et deviceRAM lt 2048 et 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.

Champs Opérateurs pris en charge Description
market 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
deviceType eq, ne Une des chaînes suivantes :
  • PC
  • Téléphone
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Holographique
  • Inconnu
isRevised eq, ne Spécifiez true pour filtrer les révisions qui ont été révisées ; sinon false.
packageVersion eq, ne Version du package d’application qui a été examiné.
deviceModel eq, ne Type d’appareil sur lequel l’application a été examinée.
productFamily eq, ne Une des chaînes suivantes :
  • PC
  • Tablette
  • Téléphone
  • Mettable
  • Serveur
  • Collaboratif
  • Other
deviceRAM eq, ne, gt, lt, ge, le Ram physique, en Mo.
deviceScreenResolution eq, ne Résolution de l’écran de l’appareil au format « largeur x hauteur ».
deviceStorageCapacity eq, ne, gt, lt, ge, le Capacité du disque de stockage principal, en Go.
isTouchEnabled 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.
reviewTitle eq, ne, contient Titre de la révision.
reviewText eq, ne, contient Contenu du texte de la révision.
utileCount eq, ne Nombre de fois où l’examen a été marqué utile.
notHelpfulCount eq, ne Nombre de fois où la révision a été marquée comme non utile.
responseDate eq, ne Date à laquelle la réponse a été envoyée.
responseText eq, ne, contient Contenu du texte de la réponse.
id eq, ne ID de la révision (il s’agit d’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>

Response

Response body

Valeur Type Description
active tableau Tableau d’objets qui contiennent des données de révision. Pour plus d’informations sur les données de chaque objet, consultez la section des valeurs de révision ci-dessous.
@nextLink string 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 10000, mais qu’il existe plus de 10000 lignes de données de révision pour la requête.
TotalCount 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 Valeur contiennent les valeurs suivantes.

Valeur Type Description
date string 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 requête 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 string ID Store de l’application pour laquelle vous récupérez des données de révision.
applicationName string Nom complet de l'application.
market string Code pays ISO 3166 du marché où l’examen a été soumis.
osVersion string 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 champs de filtre ci-dessus.
deviceType string Type d’appareil sur lequel la révision a été soumise. Pour obtenir la liste des chaînes prises en charge, consultez la section champs de filtre ci-dessus.
isRevised Boolean La valeur true indique que la révision a été révisée ; sinon false.
packageVersion string Version du package d’application qui a été examiné.
deviceModel string Type d’appareil sur lequel l’application a été examinée.
productFamily string Nom de la famille d’appareils. Pour obtenir la liste des chaînes prises en charge, consultez la section champs de filtre ci-dessus.
deviceRAM nombre Ram physique, en Mo.
deviceScreenResolution string Résolution de l’écran de l’appareil au format « largeur x hauteur ».
deviceStorageCapacity nombre Capacité du disque de stockage principal, en Go.
isTouchEnabled Boolean La valeur true indique que l’interaction tactile est activée ; sinon false.
reviewerName string Nom du réviseur.
rating nombre Évaluation de l’application, en étoiles.
reviewTitle string Titre de la révision.
reviewText string Contenu du texte de la révision.
utileCount nombre Nombre de fois où l’examen a été marqué utile.
notHelpfulCount nombre Nombre de fois où la révision a été marquée comme non utile.
responseDate string Date à laquelle une réponse a été envoyée.
responseText string Contenu du texte de la réponse.
id string ID de la révision (il s’agit d’un GUID). Vous pouvez utiliser cet ID dans les informations de réponse pour les révisions d’application et envoyer des réponses aux méthodes de révision d’application .

Exemple de requête 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
}