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)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
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ę.
reviewMediaItems[]

object (ReviewMediaItem)

Tylko dane wyjściowe. Pliki 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 recenzenta. Wypełniane tylko wtedy, gdy wartość isAnonymous to „false”.
displayName

string

Imię i nazwisko autora opinii. Zawiera prawdziwe imię i nazwisko osoby dodającej opinię tylko wtedy, gdy wartość parametru 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),
  "policyViolation": enum (PolicyViolation)
}
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ę.
policyViolation

enum (PolicyViolation)

Opcjonalnie. Tylko dane wyjściowe. Naruszenie zasad, które spowodowało odrzucenie. Wartość jest podawana tylko wtedy, gdy reviewReplyState ma wartość REJECTED.

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.

PolicyViolation

Reprezentuje standardowe naruszenia zasad. W przyszłości możemy dodać nowe wartości. Klienci powinni być przygotowani na obsługę nieznanych wartości.

Wartości w polu enum
POLICY_VIOLATION_UNSPECIFIED Reprezentuje nieokreślone naruszenie zasad.
ACCOUNT_RESTRICTED_AND_SUSPENDED Konto Google powiązane z tym profilem firmy jest objęte ograniczeniami, co spowodowało zawieszenie profilu firmy.
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED Konto Google powiązane z tym profilem firmy jest objęte ograniczeniami, co powoduje odrzucanie zmian. W przeciwieństwie do kodu ACCOUNT_RESTRICTED_AND_SUSPENDED sam profil firmy pozostaje aktywny i nie jest zawieszony.
ASSOCIATED_ACCOUNT_SUSPENDED Stan konta Google powiązanego z tym profilem firmy jest niezadowalający. Profile firmy powiązane z tym kontem zostały zawieszone.
BUSINESS_INELIGIBLE Twoja firma nie kwalifikuje się do utworzenia konta w Profilu Firmy.
OWNERSHIP_REVOKED Inne konto Google potwierdziło, że jest właścicielem tego profilu firmy. Nie możesz już zarządzać tym profilem.
LOCATION_SUSPENDED Ten profil firmy został zawieszony.
LOCATION_DISABLED Ten profil firmy został wyłączony.
LOCATION_VERIFICATION_REQUIRED Ten profil firmy nie został zweryfikowany.
PO_BOX Profil Twojej firmy został zawieszony, ponieważ adres firmy nie może być numerem skrytki pocztowej.
GOOGLE_PAY_SUSPENSION Profile firm powiązane z Twoim profilem płatności zostały zawieszone.
EDITING_RESTRICTION Ten profil firmy ma obecnie ograniczone możliwości otrzymywania publicznych aktualizacji. Wyłączyliśmy możliwość edytowania informacji o tym miejscu, aby zapobiec publikowaniu treści naruszających zasady.
ILLEGAL_BUSINESS_HOURS_EDIT W przypadku swojej kategorii działalności nie możesz edytować godzin otwarcia.
FAKE_ENGAGEMENT Treści, które naruszają nasze zasady dotyczące fałszywego zaangażowania, są niedozwolone. Fałszywe zaangażowanie obejmuje treści zachęcające do publikacji w zamian za korzyści, treści mające na celu manipulowanie oceną miejsca oraz inne treści, które nie odzwierciedlają autentycznych wrażeń użytkowników.
ADULT_THEMED Treści, które naruszają nasze zasady dotyczące treści dla dorosłych, są niedozwolone. Treści dla dorosłych to zarówno treści o charakterze seksualnym, jak i inne treści dla dorosłych.
SEXUALLY_EXPLICIT Treści, które naruszają nasze zasady dotyczące treści o charakterze jednoznacznie seksualnym, są niedozwolone. Treści o charakterze jednoznacznie seksualnym to treści, które prezentują nagie genitalia lub przedstawiają bądź opisują akty seksualne.
ADVERTISING_AND_SOLICITATION Treści, które naruszają nasze zasady dotyczące treści reklamowych lub promocyjnych, są niedozwolone. Treści reklamowe i promocyjne obejmują materiały promocyjne i reklamowe oraz treści publikowane w zamian za korzyści.
DANGEROUS Treści, które naruszają nasze zasady dotyczące treści niebezpiecznych, są niedozwolone. Treści niebezpieczne to treści, które promują, wspierają lub ułatwiają podejmowanie szkodliwych działań.
GIBBERISH_AND_REPETITIVE Treści, które naruszają nasze zasady dotyczące niejasnych lub powtarzalnych treści, są niedozwolone. Niejasne lub powtarzalne treści nie dostarczają użytkownikom przydatnych informacji.
REPETITIVE Treści, które naruszają nasze zasady dotyczące powtarzalnych treści, są niedozwolone. Powtarzalne treści to identyczne lub podobne treści dodane wiele razy z jednego bądź większej liczby kont.
UNCLEAR Treści, które naruszają nasze zasady dotyczące niejasnych treści, są niedozwolone. Niejasne treści to losowe znaki lub inne teksty pozbawione znaczenia.
ILLEGAL Treści, które naruszają nasze zasady dotyczące treści niezgodnych z prawem, są niedozwolone.
OFF_TOPIC Treści, które naruszają nasze zasady dotyczące treści nie na temat, są niedozwolone. Treści nie na temat to między innymi ogólne komentarze na tematy społeczne, polityczne lub osobiste.
OFFENSIVE Treści, które naruszają nasze zasady dotyczące obraźliwych treści, są niedozwolone. Obraźliwe treści to takie, które w sposób uzasadniony wywołują w innych użytkownikach skrajny gniew, oczerniają ich lub wyrażają brak szacunku.
VIOLENCE_AND_GORE Treści, które naruszają nasze zasady dotyczące przemocy i okrucieństwa, są niedozwolone. Treści przedstawiające przemoc lub okrucieństwo to treści dotyczące ludzi lub zwierząt, które w sposób drastyczny przedstawiają realistyczne akty przemocy, krew, części ciała lub wnętrzności.
CHILD_SAFETY Treści, które naruszają nasze zasady dotyczące bezpieczeństwa dzieci, są niedozwolone. Do tej kategorii zaliczamy treści stwarzające zagrożenie dla dzieci, prezentujące wykorzystywanie dzieci lub przemoc wobec nich oraz treści, które używają usług Google w sposób stwarzający zagrożenie dla dzieci.
HARASSMENT Treści, które naruszają nasze zasady dotyczące nękania, są niedozwolone. Nękanie obejmuje zachowania, które polegają na dręczeniu, seksualizacji lub zastraszaniu użytkownika albo na stosowaniu wobec niego gróźb.
HATE_SPEECH Treści, które naruszają nasze zasady dotyczące szerzenia nienawiści, są niedozwolone. Szerzenie nienawiści obejmuje nawoływanie do przemocy lub nienawiści wobec konkretnych osób lub grup, promujące ich dyskryminację lub ubliżające im ze względu na cechy objęte ochroną lub dowolne inne cechy powiązane z dyskryminacją systemową lub marginalizacją.
IMPERSONATION Treści, które naruszają nasze zasady dotyczące podszywania się pod inne osoby, są niedozwolone. Podszywanie się pod inne osoby oznacza przyjmowanie fałszywej tożsamości w celu wprowadzenia innych w błąd lub uzyskania nienależnych korzyści.
MISINFORMATION Treści, które naruszają nasze zasady dotyczące nieprawdziwych informacji, są niedozwolone. Nieprawdziwe informacje to fałszywe lub niedokładne informacje, które mogą spowodować istotne szkody dla osób, firm lub stowarzyszeń.
MISREPRESENTATION Treści, które naruszają nasze zasady dotyczące wprowadzania użytkowników w błąd, są niedozwolone. Wprowadzanie w błąd to przedstawianie nieprawdziwych informacji lub pomijanie informacji w celu uzyskania nienależnych korzyści.
OBSCENITY_AND_PROFANITY Treści, które naruszają nasze zasady dotyczące treści nieprzyzwoitych lub wulgarnych, są niedozwolone. Treści nieprzyzwoite i wulgarne to słowa lub gesty, które są lokalnie uznawane za społecznie obraźliwe lub wulgarne.
PERSONAL_INFO Treści, które naruszają nasze zasady dotyczące danych osobowych, są niedozwolone. Dane osobowe to treści zawierające prywatne lub poufne informacje – takie jak dane kart kredytowych, dokumentacja medyczna czy dokumenty tożsamości – niezależnie od tego, czy są to Twoje czy czyjeś dane.
REGULATED_GOODS_AND_SERVICES Treści, które naruszają nasze zasady dotyczące towarów i usług objętych regulacjami, są niedozwolone. Obejmuje to treści zawierające wezwania do działania lub oferty sprzedaży produktów bądź usług podlegających lokalnym przepisom prawnym.
GENERIC_VANDALISM Treści, które naruszają nasze zasady dotyczące treści nieodpowiednich lub niskiej jakości, są niedozwolone.
GENERIC_FRAUD Treści, które naruszają nasze zasady dotyczące treści i działań wprowadzających w błąd, są niedozwolone. Treści wprowadzające w błąd mają celowo oszukiwać innych użytkowników.
PHOTOS_AND_VIDEOS_CRITERIA Treści, które nie spełniają naszych kryteriów dotyczących zdjęć i filmów, są niedozwolone.
MODERATION_ERROR Podczas przetwarzania treści wystąpił błąd.
PRIVACY Treści, które naruszają politykę prywatności treści publikowanych przez użytkowników Map Google, są niedozwolone.
GENERIC_VIOLATION Twoje treści naruszają nasze zasady. Takie treści są niedozwolone.
GENERIC_QUALITY Treści, które naruszają nasze zasady dotyczące treści niskiej jakości, są niedozwolone.
IDENTITY_CHANGE Wprowadzona przez Ciebie zmiana bardzo różni się od utworzonej firmy. Narusza to nasze zasady.
GEOGRAPHIC_LOCATION_CHANGE Wskazuje, że fizyczna lokalizacja geograficzna firmy (adres lub szerokość i długość geograficzna) uległa znaczącej zmianie od czasu utworzenia profilu.

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 występuje parametr 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 podzieloną na strony listę opinii o określonym miejscu.

updateReply

 Aktualizuje odpowiedź na określoną opinię.