Method: accounts.locations.batchGetReviews

Zwraca podzieloną na strony listę opinii dla wszystkich określonych lokalizacji. Ta operacja jest prawidłowa tylko wtedy, gdy określone lokalizacje zostaną 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, na temat których mają zostać pobrane opinie, określony nazwami.
pageSize

integer

Liczba opinii do pobrania na stronę. Wartością domyślną jest 50.
pageToken

string

Jeśli podasz wartość, zostanie pobrana kolejna strona z opiniami.
orderBy

string

Opcjonalnie. Określa pole, według którego mają być sortowane opinie. Jeśli nie określono inaczej, domyślna kolejność zwracanych opinii to updateTime desc. Prawidłowe zamówienia sortowania to rating, rating desc i updateTime desc. rating zwróci opinie w kolejności rosnącej. Argument updateTime(tj. rosnąco) nie jest obsługiwany.
ignoreRatingOnlyReviews

boolean

Określa, czy recenzje tylko z ocenami mają być ignorowane.

Treść odpowiedzi

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

Odpowiedź na pytanie Opinie.BatchGetReviews.

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

object (LocationReview)

Opinie z informacjami o lokalizacji.
nextPageToken

string

Jeśli liczba opinii przekracza żądany rozmiar strony, to pole jest wypełniane tokenem służącym do pobierania następnej strony opinii przy kolejnych wywołaniach. Jeśli nie ma więcej opinii, to pole nie będzie 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 artykule Omówienie protokołu OAuth 2.0.

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.