Obtenir les avis sur les applications

Article
07/05/2024

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
}

Partager via

Obtenir les avis sur les applications

Prérequis

Requête

Syntaxe de la requête

En-tête de requête

Paramètres de la demande

Champs Filtrer

Exemple de requête

Response

Response body

Passer en revue les valeurs

Exemple de requête et de réponse

Exemple de requête

Exemple de réponse

Commentaires

Ressources supplémentaires

Partager via

Obtenir les avis sur les applications

Prérequis

Requête

Syntaxe de la requête

En-tête de requête

Paramètres de la demande

Champs Filtrer

Exemple de requête

Response

Response body

Passer en revue les valeurs

Exemple de requête et de réponse

Exemple de requête

Exemple de réponse

Rubriques connexes

Commentaires

Ressources supplémentaires