Method: accounts.locations.reviews.list

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

HTTP-запрос

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

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

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

Параметры
parent

string

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

Параметры запроса

Параметры
pageSize

integer

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

pageToken

string

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

orderBy

string

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

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

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

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

JSON-представление 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Поля
reviews[]

object ( Review )

Отзывы.

averageRating

number

Средний рейтинг всех отзывов об этом месте по шкале от 1 до 5, где 5 — высший рейтинг.

totalReviewCount

integer

Общее количество отзывов об этом месте.

nextPageToken

string

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

Области авторизации

Требуется одна из следующих областей OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .