Obtenir les avis sur les applications

  • Article

Utilisez cette méthode dans l’API d’analyse 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.

Une fois que vous avez récupéré les révisions, vous pouvez utiliser les informations de réponse pour les révisions d’application et envoyer des réponses aux méthodes de révision 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 vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API d’analyse du Microsoft Store.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de 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 arrivé à expiration, 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 sous la formeJeton> du porteur<.

Paramètres de la demande

Paramètre Type Description Obligatoire
applicationId string ID Store de l’application pour laquelle vous souhaitez récupérer des données de révision. Oui
startDate Date Dans la plage de dates, la date de début de la récupération des avis. La valeur par défaut est la date actuelle. Non
endDate Date Dans la plage de dates, la date de début de la récupération des avis. La valeur par défaut est la date actuelle. Non
top int Le nombre de lignes de données à renvoyer dans la requête. La valeur maximale et la valeur par défaut en l’absence de définition est 10000. Si la requête comporte davantage de lignes, le corps de la réponse inclut un lien sur lequel vous cliquez pour solliciter la page suivante de données. Non
skip int Le nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir de grands ensembles de données. Par exemple, indiquez top=10000 et skip=0 pour obtenir les 10000 premières lignes de données, top=10000 et skip=10000 pour obtenir les 10000 lignes suivantes, et ainsi de suite. Non
filter string Une ou plusieurs instructions qui filtrent les lignes de la réponse. Pour plus d’informations, voir la section Champs de filtre ci-dessous. Non
orderby string Instruction commandant les valeurs des données de résultats. La syntaxe est orderby=field [order], field [order],.... Le paramètre field peut être l’une des chaînes suivantes :
  • date
  • osVersion
  • Marché
  • deviceType
  • isRevised
  • packageVersion
  • deviceModel
  • productFamily
  • deviceScreenResolution
  • isTouchEnabled
  • reviewerName
  • reviewTitle
  • reviewText
  • helpfulCount
  • notHelpfulCount
  • responseDate
  • responseText
  • deviceRAM
  • deviceStorageCapacity
  • Évaluation

Le paramètre order, facultatif, peut comporter les valeurs asc ou desc afin de 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 filtrage

Le paramètre filter de la requête contient une ou plusieurs instructions qui filtrent les lignes de la réponse. Chaque instruction comporte un champ et une valeur qui sont 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 des opérateurs and ou or.

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

Pour obtenir une liste des champs pris en charge et des opérateurs associés à chacun d’entre eux, consultez le tableau suivant. Les valeurs de chaîne doivent être entourées par des guillemets dans le paramètre filter.

Champs Opérateurs pris en charge Description
market eq, ne Chaîne contenant le code pays ISO 3166 du marché des appareils.
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
  • Unknown
deviceType eq, ne Une des chaînes suivantes :
  • PC
  • Téléphone
  • Console-Xbox One
  • Console-Xbox Series X
  • IoT
  • Hologrammes
  • Unknown
isRevised eq, ne Spécifiez la valeur true pour filtrer les avis révisés ; sinon, définissez la valeur false.
packageVersion eq, ne La version du package d’application qui a été passée en revue.
deviceModel eq, ne Le type d’appareil sur lequel l’application a été révisée.
productFamily eq, ne Une des chaînes suivantes :
  • PC
  • Tablette
  • Téléphone
  • Wearable
  • Serveur
  • Collaboration
  • Autres
deviceRAM eq, ne, gt, lt, ge, le Mémoire RAM physique, en Mo.
deviceScreenResolution eq, ne Résolution de l’écran de l’appareil au format « width x height ».
deviceStorageCapacity eq, ne, gt, lt, ge, le Capacité du disque de stockage principal, en Go.
isTouchEnabled eq, ne Spécifiez la valeur true pour filtrer les appareils tactiles ; sinon, définissez la valeur false.
reviewerName eq, ne Nom de réviseur.
rating eq, ne, gt, lt, ge, le Classification de l’application, en étoiles.
reviewTitle eq, ne, contains Le titre de l’avis.
reviewText eq, ne, contains Texte de l’avis.
helpfulCount eq, ne Le nombre d’occurrences où l’avis a été marqué comme utile.
notHelpfulCount eq, ne Nombre d’occurrences où l’avis a été signalé comme inutile.
responseDate eq, ne Date à laquelle la réponse a été soumise.
responseText eq, ne, contains 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 requêtes de récupération des avis. Remplacez la valeur applicationId par l’ID Windows 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
Valeur tableau Un tableau d’objets comportant des avis. Pour plus d’informations sur les données de chaque objet, consultez la section Valeurs d’avis ci-dessous.
@nextLink string S’il existe des pages supplémentaires de données, cette chaîne comporte un URI que vous pouvez utiliser pour solliciter la page suivante de données. Par exemple, cette valeur est renvoyée si le paramètre top de la requête est défini sur 10000, mais que plus de 10000 lignes de données d’avis sont associées à la requête.
TotalCount int Nombre total de lignes dans les résultats de la requête.

 

Valeurs d’avis

Les éléments du tableau Value comportent les valeurs suivantes :

Valeur Type Description
Date string Première date dans la plage de dates des données d’avis. Si la requête spécifiait un jour précis, cette valeur correspond à la date. Si la requête était relative à une semaine, un mois ou toute autre plage de dates, cette valeur correspond à la première date de la plage de dates.
applicationId string ID Windows Store de l’application dont vous récupérez les données d’avis.
applicationName string Nom d’affichage de l’application.
market string Code pays ISO 3166 du marché où l’avis a été soumis.
osVersion string Version du système d’exploitation sur lequel l’avis a été soumis. Pour obtenir la liste des chaînes prises en charge, consultez la section Champs de filtrage ci-dessus.
deviceType string Type d’appareil sur lequel l’avis a été soumis. Pour obtenir la liste des chaînes prises en charge, consultez la section Champs de filtrage ci-dessus.
isRevised Boolean La valeur true indique que l’avis a été révisé ; sinon, la valeur false est affichée.
packageVersion string La version du package d’application qui a été passée en revue.
deviceModel string Le type d’appareil sur lequel l’application a été révisée.
productFamily string Le nom de la famille d’appareils. Pour obtenir la liste des chaînes prises en charge, consultez la section Champs de filtrage ci-dessus.
deviceRAM nombre Mémoire 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 l’activation de l’interaction tactile ; sinon, la valeur false est affichée.
reviewerName string Nom de réviseur.
rating nombre Classification de l’application, en étoiles.
reviewTitle string Le titre de l’avis.
reviewText string Texte de l’avis.
helpfulCount nombre Le nombre d’occurrences où l’avis a été marqué comme utile.
notHelpfulCount nombre Nombre d’occurrences où l’avis a été signalé comme inutile.
responseDate string Date de soumission d’une réponse.
responseText string 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 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 requête et de réponse

Les extraits de code suivants illustrent quelques exemples de requête et de corps de réponse JSON pour ces demandes.

Exemple de demande

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
}