Method: accounts.locations.batchGetReviews

Возвращает постраничный список отзывов для всех указанных местоположений. Эта операция действительна только в том случае, если указанные местоположения подтверждены.

HTTP-запрос

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

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Название учетной записи, с которой будет получен список отзывов из нескольких мест.

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Поля
locationNames[]

string

A collection of locations to fetch reviews for, specified by their names.

pageSize

integer

Сколько отзывов загружается на страницу. Значение по умолчанию — 50.

pageToken

string

Если указано иное, отобразится следующая страница отзывов.

orderBy

string

Необязательный параметр. Указывает поле для сортировки отзывов. Если параметр не указан, порядок возвращаемых отзывов будет по умолчанию соответствовать полю updateTime desc . Допустимые порядки сортировки: rating , rating desc и updateTime desc . rating вернет отзывы в порядке возрастания. updateTime (т.е. в порядке возрастания) не поддерживается.

ignoreRatingOnlyReviews
(deprecated)

boolean

Стоит ли игнорировать отзывы, содержащие только оценки.

Ответный текст

Ответное сообщение для Reviews.BatchGetReviews.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Поля
locationReviews[]

object ( LocationReview )

Отзывы с указанием местоположения.

nextPageToken

string

Если количество отзывов превышает запрошенный размер страницы, это поле заполняется токеном для получения следующей страницы отзывов при последующих запросах. Если отзывов больше нет, это поле не будет присутствовать в ответе.

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

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

Для получения более подробной информации см.OAuth 2.0 Overview .

Обзор местоположения

Представляет собой отзыв с указанием местоположения.

JSON-представление 
{
  "name": string,
  "review": {
    object (Review)
  }
}
Поля
name

string

Название ресурса местоположения.

review

object ( Review )

Отзыв о местоположении.