L'API Reply to Reviews de Google Play vous permet de consulter les commentaires des utilisateurs. pour votre application et répondez à ce commentaire. Vous pouvez utiliser cette API pour interagir avec les utilisateurs directement depuis votre boîte à outils de service client existante, comme un CRM ; du système d'exploitation.
L'API Reply to Reviews ne vous permet d'accéder aux commentaires que pour la production. de votre application. Si vous souhaitez obtenir des commentaires sur les versions alpha ou bêta votre application, utilisez plutôt la Google Play Console. Notez également que l'API n'affiche que les avis qui comportent des commentaires. Si un utilisateur évalue votre application, ne pas laisser de commentaire, cela signifie qu'il n'est pas accessible depuis l'API.
Accès
Pour utiliser l'API Reply to Reviews, vous devez fournir une autorisation à l'aide d'un un client OAuth ou un compte de service. Si vous utilisez un compte de service, activez "Répondre à des avis" au sein de ce compte. Pour en savoir plus sur établissant un accès autorisé à cette API, consultez Configurer les clients d'accès à l'API
Récupération d'avis
Lorsque vous utilisez l'API Reply to Reviews, vous pouvez récupérer la liste des des avis pour votre application, ou afficher un avis individuel.
Récupérer un ensemble d'avis
Utilisez la méthode GET pour demander la liste des avis pour votre application. Dans votre demande,
incluez le nom complet du package de votre application,
com.google.android.apps.maps, et le jeton d'autorisation que vous avez reçu lors de
obtenir l'accès à l'API.
GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews? access_token=your_auth_token
La réponse est une chaîne JSON contenant une liste d'avis pour votre application. La le premier résultat de la liste affiche le dernier commentaire de l'utilisateur ou modifiées.
Dans l'exemple suivant, le premier avis présente les métadonnées qui apparaissent dans et le second affiche des métadonnées qui n'apparaissent que dans certains résultats:
{
"reviews": [
{
"reviewId": "12345678",
"authorName": "Jane Bloggs",
"comments": [
{
"userComment": {
"text": "This is the best app ever!",
"lastModified": {
"seconds": "1443676826",
"nanos": 713000000
},
"starRating": 5
}
}
]
},
{
"reviewId": "11223344",
"authorName": "John Doe",
"comments": [
{
"userComment": {
"text": "I love using this app!",
"lastModified": {
"seconds": "141582134",
"nanos": 213000000
},
"starRating": 5,
"reviewerLanguage": "en",
"device": "trltecan",
"androidOsVersion": 21,
"appVersionCode": 12345,
"appVersionName": "1.2.3",
"thumbsUpCount": 10,
"thumbsDownCount": 3,
"deviceMetadata": {
"productName": "E5333 (Xperia™ C4 Dual)",
"manufacturer": "Sony",
"deviceClass": "phone",
"screenWidthPx": 1080,
"screenHeightPx": 1920,
"nativePlatform": "armeabi-v7a,armeabi,arm64-v8a",
"screenDensityDpi": 480,
"glEsVersion": 196608,
"cpuModel": "MT6752",
"cpuMake": "Mediatek",
"ramMb": 2048
}
}
},
{
"developerComment": {
"text": "That's great to hear!",
"lastModified": {
"seconds": "1423101467",
"nanos": 813000000
}
}
}
]
}
],
"tokenPagination": {
"nextPageToken": "12334566"
}
}
Chaque résultat inclut les métadonnées suivantes:
- reviewId
- Identifie de façon unique cet avis. Il indique également les car les utilisateurs ne peuvent rédiger qu'un seul avis pour une application spécifique.
- authorName
Nom de l'utilisateur qui rédige l'avis.
Remarque:Dans de rares cas,
authorNamepeut n'apparaissent pas dans un résultat donné.- comments
Liste incluant les commentaires de l'utilisateur sur l'application. Si cette inclut un titre, ce titre et le corps de l'avis apparaissent tous les deux dans l'élément
text, et une tabulation sépare le titre et le corps du texte. L'élémentlastModifiedindique l'heure à laquelle l'utilisateur a envoyé son avis.Si vous avez déjà répondu à cet avis, vos commentaires apparaissent en tant que le deuxième élément de la liste des commentaires.
- starRating
Évaluation de votre application par l'utilisateur sur une échelle de 1 à 5. Un score de 5 indique que l'utilisateur est très satisfait de votre application.
Par défaut, 10 avis s'affichent sur chaque page. Vous pouvez afficher jusqu'à 100 avis
par page en définissant le paramètre maxResults dans votre requête.
Si la liste des avis continue sur une autre page, l'API inclut une balise
tokenPagination dans la réponse. Lorsque vous demandez la page suivante
les avis, vous devez inclure l'élément token. Définissez la valeur de cet élément sur
Valeur nextPageToken, qui apparaît dans la réponse d'origine.
Remarque:Vous ne pouvez récupérer que les avis créés par les utilisateurs. ou modifié au cours de la semaine précédente. Si vous souhaitez récupérer tous les avis application depuis le début, vous pouvez la télécharger vos avis dans un fichier CSV via la Google Play Console.
L'exemple de requête GET suivant affiche la page d'avis suivante. Ce
suppose que la page d'avis actuelle (comme indiqué dans la réponse
la requête précédente) contient une valeur nextPageToken de "12334566". La
indique également que la page suivante doit afficher jusqu'à 50 avis.
GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews? access_token=your_auth_token&token=12334566&maxResults=50
Récupérer un avis individuel
Vous pouvez également utiliser la méthode GET pour récupérer un avis individuel. Ce que vous indiquez
la même URL que celle utilisée pour
récupérer un ensemble d'avis, sauf que vous
Incluez également le review_id correspondant à l'avis que vous souhaitez afficher:
GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/ review_id?access_token=your_auth_token
La réponse correspondante est une chaîne JSON comportant du contenu et des métadonnées pour un avis unique:
{
"reviewId": "87654321",
"authorName": "Joan Smith",
"comments": [
{
"userComment": {
"text": "This app is awesome!",
"lastModified": {
"seconds": "1452114723",
"nanos": 913000000
},
"starRating": 5
}
}
]
}
Traduire le texte de l'avis
Le texte de l'avis peut être traduit automatiquement avant d'être renvoyé à partir de la
l'API reviews. Lorsque vous récupérez une liste d'avis ou un seul avis, ajoutez
un paramètre translationLanguage à la requête. Exemple :
GET https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews? access_token=your_auth_token&translationLanguage=en
Le paramètre translationLanguage permet de spécifier une langue avec ou sans
pays. Par exemple, "en" et "en_GB" sont valides.
Si vous spécifiez une langue de traduction différente de la langue d'origine
le texte traduit, le système renvoie le texte traduit dans la propriété text.
texte d'origine dans la propriété originalText. Exemple :
{
"reviewId": "12345678",
"authorName": "Jane Bloggs",
"comments": [
{
"userComment": {
"text": "This is the best app ever!",
"lastModified": {
"seconds": "1443676826",
"nanos": 713000000
},
"starRating": 5,
"originalText": "Dies ist die beste App überhaupt!"
}
}
]
}
Répondre aux avis
Vous pouvez également interagir avec les utilisateurs de votre application en répondant à leurs avis. Après vous envoyez votre réponse, l'utilisateur reçoit une notification indiquant que ont répondu à leurs commentaires.
Nous déconseillons l'utilisation de réponses automatiques aux avis, dans le but en mettant à jour ces réponses manuellement par la suite. Par ailleurs, même si vous pouvez répondre à un avis autant de fois que vous le souhaitez, l'utilisateur ne reçoit qu'une notification après la première réponse à un avis créé ou modifié. Les éléments suivants : illustre la manière dont l'utilisateur est notifié lors de vos interactions avec lui:
| Interaction utilisateur-développeur | Notification envoyée à l'utilisateur ? |
|---|---|
| L'utilisateur écrit un avis. le développeur envoie sa réponse | Oui |
| Mise à jour du développeur : réponse à l'avis d'origine | Non |
| Examen des mises à jour utilisateur réponse aux mises à jour du développeur | Oui |
Remarque:Vos réponses aux avis apparaissent publiquement sur le page de plate-forme de téléchargement d'applications, vous devez ne pas inclure d'informations sensibles sur les utilisateurs lorsque vous rédigez ces réponses.
Pour envoyer une réponse à un avis d'utilisateur, utilisez la méthode POST. Dans votre demande,
indiquer que Content-Type est application/json et inclure un fichier JSON
document contenant votre réponse:
POST https://www.googleapis.com/androidpublisher/v3/applications/your_package_name/reviews/
review_id:reply?access_token=your_access_token
Content-Type: application/json
{
"replyText": "Thanks for your feedback!"
}
Remarque:Le replyText que vous incluez dans votre
La requête POST ne peut pas contenir plus de 350 caractères. Vous devez utiliser
votre réponse en texte brut ; les balises HTML correctement formatées sont supprimées et ne sont pas
seront inclus dans le nombre de caractères de votre réponse. Le contenu que vous placez
dans des balises HTML bien formées est toutefois conservée.
Si votre requête aboutit, vous recevez la chaîne JSON suivante en réponse.
L'élément lastEdited indique l'heure à laquelle l'API enregistre votre réponse.
à l'avis de l'utilisateur.
{
"result": {
"replyText": "Thanks for your feedback!",
"lastEdited": {
"seconds": "1453978803",
"nanos": 796000000
}
}
}
Toutefois, si votre requête POST n'est pas valide, la réponse affiche l'une des
codes d'erreur suivants:
400 Bad Reply Request- Le champ
replyTextest trop long ou manquant. 404 Not Found- Il n'existe pas d'avis correspondant à l'élément
review_idindiqué.
Quotas
Par courtoisie envers les autres développeurs, l'API Reply to Reviews est des quotas. Ces quotas sont appliqués séparément pour chaque application:
Demandes
GET(pour récupérer les listes d'avis et d'avis individuels) – 200 par heurePOSTdemandes (pour répondre aux avis) – 2 000 par jour
Si votre application a besoin de récupérer un plus grand nombre d'avis ou d'y répondre les quotas autorisent, envoyez une demande pour augmenter le quota de votre application.