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 vous souhaitez récupérer la liste des avis concernant 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

Ensemble d'établissements pour lesquels extraire des avis, identifié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, la page d'avis suivante est récupérée.
orderBy

string

Facultatif. Spécifie le champ selon lequel trier les avis. Si aucune valeur n'est spécifiée, l'ordre des avis renvoyés sera défini par défaut sur updateTime desc. Les ordres de tri valides sont rating, rating desc et updateTime desc. rating affichera les avis dans l'ordre croissant. updateTime(par ordre croissant) n'est pas accepté.
ignoreRatingOnlyReviews

boolean

Permet d'ignorer ou non les avis uniquement.

Corps de la réponse

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

Message de réponse pour Reviews.BatchGetReviews.

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

object (LocationReview)

Avis avec des informations de localisation.
nextPageToken

string

Si le nombre d'avis dépasse la taille de page demandée, ce champ est renseigné avec un jeton permettant d'extraire la page d'avis suivante lors des appels suivants. 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 champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

LocationReview

Représente un avis avec des informations géographiques.

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

string

Nom de la ressource d'emplacement.
review

object (Review)

Avis sur l'établissement.