Method: accounts.locations.batchGetReviews

Zwraca podzieloną na strony listę opinii dla wszystkich określonych lokalizacji. Ta operacja jest prawidłowa tylko pod warunkiem, że podane lokalizacje zostały 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 ma zostać pobrana lista opinii w wielu lokalizacjach.

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, o których pobierane są opinie, określone za pomocą nazw.
pageSize

integer

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

string

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

string

Opcjonalnie: Określa pole, według którego mają być sortowane opinie. Jeśli nie określono inaczej, kolejność zwracanych opinii będzie domyślnie ustawiona na updateTime desc. Prawidłowe zamówienia, według których można sortować, to rating, rating desc i updateTime desc. Funkcja rating wyświetli opinie w kolejności rosnącej. Metoda updateTime(np. w kolejności rosnącej) nie jest obsługiwana.
ignoreRatingOnlyReviews

boolean

Określa, czy mają ignorować opinie tylko z oceną.

Treść odpowiedzi

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

Komunikat z odpowiedzią dla Reviews.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, w tym polu pojawia się token, który przy kolejnych wywołaniach pobierze następną stronę opinii. Jeśli nie ma więcej opinii, to pole nie będzie widoczne w odpowiedzi.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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.