REST Resource: accounts.locations.reviews

Zasób: Review

Tylko dane wyjściowe. Reprezentuje opinię o miejscu.

Zapis JSON
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  }
}
Pola
name

string

Nazwa zasobu. W przypadku opinii ma on postać accounts/{accountId}/locations/{locationId}/reviews/{reviewId}

reviewId

string

Zaszyfrowany unikalny identyfikator.

reviewer

object (Reviewer)

Autor opinii.

starRating

enum (StarRating)

Ocena w postaci gwiazdek.

comment

string

Treść opinii jako zwykły tekst ze znacznikami.

createTime

string (Timestamp format)

Sygnatura czasowa napisania opinii.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Sygnatura czasowa ostatniej modyfikacji opinii.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

reviewReply

object (ReviewReply)

Odpowiedź właściciela lub menedżera tej lokalizacji na tę opinię.

Reviewer

Reprezentuje autora opinii.

Zapis JSON
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
Pola
profilePhotoUrl

string

Link do zdjęcia profilowego recenzenta. Wartość jest podawana tylko wtedy, gdy isAnonymous ma wartość „false”.

displayName

string

Imię i nazwisko autora opinii. Zawiera prawdziwe imię i nazwisko osoby dodającej opinię tylko wtedy, gdy wartość isAnonymous to „false”.

isAnonymous

boolean

Wskazuje, czy recenzent zdecydował się pozostać anonimowy.

StarRating

Ocena w skali od 1 do 5 gwiazdek, przy czym 5 to najwyższa ocena.

Wartości w polu enum
STAR_RATING_UNSPECIFIED Nie określono.
ONE 1 gwiazdka na maksymalnie 5.
TWO 2 gwiazdki na maksymalnie 5.
THREE 3 gwiazdki na 5 możliwych.
FOUR Cztery gwiazdki na maksymalnie pięć.
FIVE Maksymalna liczba gwiazdek.

ReviewReply

Reprezentuje odpowiedź właściciela lub menedżera lokalizacji na opinię.

Zapis JSON
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State)
}
Pola
comment

string

Treść odpowiedzi jako zwykły tekst ze znacznikami. Maksymalna długość to 4096 bajtów.

updateTime

string (Timestamp format)

Tylko dane wyjściowe. Sygnatura czasowa ostatniej modyfikacji odpowiedzi.

Korzysta ze standardu RFC 3339, w którym wygenerowane dane wyjściowe są zawsze znormalizowane do formatu Z i zawierają 0, 3, 6 lub 9 cyfr po przecinku. Akceptowane są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30".

reviewReplyState

enum (State)

Tylko dane wyjściowe. Stan odpowiedzi na opinię.

Stan

Reprezentuje stan moderacji odpowiedzi na opinię.

Wartości w polu enum
REVIEW_REPLY_STATE_UNSPECIFIED Wskazuje, że stan jest nieokreślony.
PENDING Wskazuje, że odpowiedź oczekuje na moderację.
REJECTED Oznacza, że odpowiedź została odrzucona.
APPROVED Oznacza, że odpowiedź została zatwierdzona.

Metody

deleteReply

Usuwa odpowiedź na określoną opinię.

get

Zwraca określoną opinię.

list

Zwraca listę opinii o określonym miejscu podzieloną na strony.

updateReply

Aktualizuje odpowiedź na określoną opinię.