Method: accounts.locations.reviews.list

Affiche la liste paginée des avis pour l'établissement spécifié. Cette opération n'est valide que si l'établissement spécifié a été validé.

Requête HTTP

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/reviews

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Nom de l'établissement pour lequel extraire des avis.

Paramètres de requête

Paramètres
pageSize

integer

Nombre d'avis à extraire par page. La valeur maximale de pageSize est de 50.
pageToken

string

Si elle est spécifiée, elle extrait la page d'avis suivante.
orderBy

string

Spécifie le champ utilisé afin de trier les avis. Si aucune valeur n'est spécifiée, l'ordre des avis affichés est défini par défaut sur updateTime desc. Voici les ordres de tri valides : rating, rating desc et updateTime desc.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour Reviews.ListReviews.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Champs
reviews[]

object (Review)

Avis.
averageRating

number

Note moyenne de tous les avis sur cet établissement, sur une échelle allant de 1 à 5 (5 étant la meilleure note).
totalReviewCount

integer

Nombre total d'avis sur cet établissement.
nextPageToken

string

Si le nombre d'avis est supérieur à la taille de page demandée, ce champ est renseigné avec un jeton permettant de récupérer la page d'avis suivante lors d'un appel ultérieur à reviews.list. S'il n'y a plus d'avis, ce champ n'est pas inclus dans la réponse.

Champs d'application des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

Pour plus d'informations, consultez la OAuth 2.0 Overview.