Method: accounts.locations.reviews.list

Zwraca podzieloną na strony listę opinii o określonej lokalizacji. Ta operacja jest prawidłowa tylko wtedy, gdy określona lokalizacja została 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, o której mają być pobierane opinie.

Parametry zapytania

Parametry
pageSize

integer

Liczba opinii do pobrania na stronę. Maksymalna liczba znaków (pageSize) to 50.
pageToken

string

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

string

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.

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 temat Reviews.ListReviews.

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

object (Review)

Opinie.
averageRating

number

Średnia ocena wszystkich opinii o tej lokalizacji w skali od 1 do 5, gdzie 5 to najwyższa ocena.
totalReviewCount

integer

Łączna liczba opinii dotyczących tej lokalizacji.
nextPageToken

string

Jeśli liczba opinii przekroczyła wymagany rozmiar strony, w tym polu pojawia się token, który posłuży do pobrania następnej strony opinii 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 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.