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

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

pageSize

integer

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

pageToken

string

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

orderBy

string

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

ignoreRatingOnlyReviews

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 .

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

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

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

string

Имя ресурса местоположения.

review

object ( Review )

Отзыв о локации.