Method: accounts.locations.batchGetReviews

Zwraca listę opinii podzieloną na strony dla wszystkich określonych lokalizacji. Ta operacja jest ważna tylko wtedy, gdy określone lokalizacje są zweryfikowane.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Nazwa konta, z którego chcesz pobrać listę opinii z wielu lokalizacji.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "locationNames": [
    string
  ],
  "pageSize": integer,
  "pageToken": string,
  "orderBy": string,
  "ignoreRatingOnlyReviews": boolean
}
Pola
locationNames[]

string

Zbiór lokalizacji, dla których mają być pobierane opinie, określonych za pomocą nazw.

pageSize

integer

Liczba opinii do pobrania na stronę. Wartość domyślna to 50.

pageToken

string

Jeśli jest określony, pobiera następną stronę opinii.

orderBy

string

Opcjonalnie. Określa pole, według którego mają być sortowane opinie. Jeśli nie podasz tego parametru, kolejność zwracanych opinii będzie domyślnie ustawiona na updateTime desc. Prawidłowe kolejności sortowania to rating, rating descupdateTime desc. rating zwróci opinie w kolejności rosnącej. updateTime(czyli kolejność rosnąca) nie jest obsługiwana.

ignoreRatingOnlyReviews
(deprecated)

boolean

Czy ignorować opinie zawierające tylko ocenę.

Treść odpowiedzi

Wiadomość z odpowiedzią dla metody Reviews.BatchGetReviews.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "locationReviews": [
    {
      object (LocationReview)
    }
  ],
  "nextPageToken": string
}
Pola
locationReviews[]

object (LocationReview)

opinie zawierające informacje o lokalizacji;

nextPageToken

string

Jeśli liczba opinii przekracza rozmiar strony, to pole jest wypełniane tokenem, który umożliwia pobranie następnej strony opinii w kolejnych wywołaniach. Jeśli nie ma więcej opinii, to pole nie będzie obecne w odpowiedzi.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w sekcji OAuth 2.0 Overview.

LocationReview

Reprezentuje opinię z informacjami o lokalizacji.

Zapis JSON
{
  "name": string,
  "review": {
    object (Review)
  }
}
Pola
name

string

Nazwa zasobu lokalizacji.

review

object (Review)

Opinia o lokalizacji.