- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
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 |
Nazwa lokalizacji, na temat której mają zostać pobrane opinie. |
Parametry zapytania
Parametry | |
---|---|
pageSize |
Liczba opinii do pobrania na stronę. Maksymalna wartość |
pageToken |
Jeśli podasz wartość, zostanie pobrana kolejna strona z opiniami. |
orderBy |
Określa pole, według którego mają być sortowane opinie. Jeśli nie określono inaczej, domyślna kolejność zwracanych opinii to |
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 ( |
Pola | |
---|---|
reviews[] |
Opinie. |
averageRating |
Średnia liczba gwiazdek ze wszystkich opinii na temat tej lokalizacji w skali od 1 do 5, gdzie 5 to najwyższa ocena. |
totalReviewCount |
Łączna liczba opinii na temat tej lokalizacji. |
nextPageToken |
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.