Method: accounts.locations.reviews.list

Zwraca podzieloną na strony listę opinii o określonej lokalizacji. Ta operacja jest prawidłowa tylko wtedy, gdy wskazana lokalizacja zostanie zweryfikowana.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa lokalizacji, na temat której mają zostać pobrane opinie.

Parametry zapytania

Parametry
pageSize

integer

Liczba opinii do pobrania na stronę. Maksymalna wartość pageSize to 50.
pageToken

string

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

string

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.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Wiadomość z odpowiedzią na Reviews.ListReviews.

Zapis JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "averageRating": number,
  "totalReviewCount": integer,
  "nextPageToken": string
}
Pola
reviews[]

object (Review)

Opinie.
averageRating

number

Średnia liczba gwiazdek ze wszystkich opinii na temat tej lokalizacji w skali od 1 do 5, gdzie 5 to najwyższa ocena.
totalReviewCount

integer

Łączna liczba opinii na temat tej lokalizacji.
nextPageToken

string

Jeśli liczba opinii przekracza żądany rozmiar strony, w tym polu pojawia się token służący do pobierania następnej strony z opiniami przy kolejnym wywołaniu strony reviews.list. Jeśli nie ma więcej opinii, to pole nie występuje 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.