Method: accounts.locations.batchGetReviews

Affiche la liste paginée des avis pour tous les établissements spécifiés. Cette opération n'est valide que si les établissements spécifiés ont été validés.

Requête HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:batchGetReviews

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom du compte à partir duquel récupérer une liste d'avis pour plusieurs établissements.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Champs
locationNames[]

string

Collection d'établissements pour lesquels extraire des avis, spécifiés par leur nom.
pageSize

integer

Nombre d'avis à extraire par page. La valeur par défaut est 50.
pageToken

string

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

string

Facultatif. 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. rating renvoie les avis par ordre croissant. updateTime(ordre croissant) n'est pas accepté.
ignoreRatingOnlyReviews
(deprecated)

boolean

Indique si vous souhaitez ignorer les avis basés uniquement sur les notes.

Corps de la réponse

Message de réponse pour Reviews.BatchGetReviews.

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

Représentation JSON 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Champs
locationReviews[]

object (LocationReview)

Avis avec des informations sur la localisation.
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. S'il n'y a plus d'avis, ce champ ne sera 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.

LocationReview

Représente un avis avec des informations sur l'établissement.

Représentation JSON 
{
  "name": string,
  "review": {
    object (Review)
  }
}
Champs
name

string

Nom de ressource de l'établissement.
review

object (Review)

Avis sur l'établissement.