REST Resource: accounts.locations.reviews

Zasób: Review

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

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

string

Nazwa zasobu. W przypadku opinii ma 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 określająca, kiedy napisano opinię.

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 określająca, kiedy opinia została ostatnio zmodyfikowana.

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ę.
reviewMediaItems[]

object (ReviewMediaItem)

Tylko dane wyjściowe. Elementy multimedialne powiązane z opinią.

Reviewer

Reprezentuje autora opinii.

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

string

Link do zdjęcia profilowego autora opinii. Wypełniane tylko wtedy, gdy isAnonymous ma wartość false.
displayName

string

Nazwa autora opinii. Wypełniane prawdziwym imieniem i nazwiskiem autora opinii tylko wtedy, gdy isAnonymous ma wartość false.
isAnonymous

boolean

Wskazuje, czy autor opinii zdecydował się pozostać anonimowy.

StarRating

Ocena w postaci gwiazdek na 5, gdzie 5 to najwyższa ocena.

Wartości w polu enum
STAR_RATING_UNSPECIFIED Nieokreślone.
ONE 1 gwiazdka na maksymalnie 5.
TWO 2 gwiazdki na maksymalnie 5.
THREE 3 gwiazdki na maksymalnie 5.
FOUR 4 gwiazdki na maksymalnie 5.
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 określająca, kiedy odpowiedź została ostatnio zmodyfikowana.

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ę. Tylko dane wyjściowe.

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 Wskazuje, że odpowiedź została odrzucona.
APPROVED Wskazuje, że odpowiedź została zaakceptowana.

ReviewMediaItem

Reprezentuje element multimedialny (zdjęcie lub film) powiązany z opinią.

Zapis JSON 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
Pola
thumbnailUrl

string

Tylko dane wyjściowe. Adres URL FIFE zdjęcia lub miniatury filmu, jeśli podano videoUrl.
thumbnailLabel

string

Tylko dane wyjściowe. Etykieta podana przez autora dla thumbnailUrl.
videoUrl

string

Tylko dane wyjściowe. Adres URL filmu do odtworzenia.

Metody

deleteReply

 Usuwa odpowiedź na określoną opinię.

get

 Zwraca określoną opinię.

list

 Zwraca listę opinii o określonej lokalizacji podzieloną na strony.

updateReply

 Aktualizuje odpowiedź na określoną opinię.