Cette page a été traduite par l'API Cloud Translation.

Répondre aux avis

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, authorName peut 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ément lastModified indique 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 replyText est trop long ou manquant.
404 Not Found: Il n'existe pas d'avis correspondant à l'élément review_id indiqué.

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 heure
POST demandes (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.