Method: accounts.locations.reviews.list

Zwraca listę opinii o określonym miejscu podzieloną na strony. Ta operacja jest ważna tylko wtedy, gdy określona lokalizacja jest 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 miejsca, dla którego chcesz pobrać opinie.

Parametry zapytania

Parametry
pageSize

integer

Liczba opinii do pobrania na stronę. Maksymalna liczba pageSize to 50.
pageToken

string

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

string

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 desc i updateTime desc.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

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

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

object (Review)

Opinie.
averageRating

number

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

integer

Łączna liczba opinii o tej 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 kolejnym wywołaniu 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 sekcji OAuth 2.0 Overview.