REST Resource: accounts.locations.reviews

משאב: בדיקה

פלט בלבד. מייצג ביקורת על מיקום.

ייצוג JSON 
{
  "name": string,
  "reviewId": string,
  "reviewer": {
    object (Reviewer)
  },
  "starRating": enum (StarRating),
  "comment": string,
  "createTime": string,
  "updateTime": string,
  "reviewReply": {
    object (ReviewReply)
  },
  "reviewMediaItems": [
    {
      object (ReviewMediaItem)
    }
  ]
}
שדות
name

string

שם המשאב במקרה של בדיקה, הוא accounts/{accountId}/locations/{locationId}/reviews/{reviewId}
reviewId

string

המזהה הייחודי המוצפן.
reviewer

object (Reviewer)

מחבר הביקורת.
starRating

enum (StarRating)

דירוג הכוכבים של הביקורת.
comment

string

תוכן הביקורת כטקסט פשוט עם תגי עיצוב.
createTime

string (Timestamp format)

חותמת הזמן של מועד כתיבת הביקורת.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

חותמת הזמן של מועד השינוי האחרון בביקורת.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
reviewReply

object (ReviewReply)

התשובה של הבעלים או המנהל של המיקום הזה לביקורת הזו.
reviewMediaItems[]

object (ReviewMediaItem)

פלט בלבד. פריטי המדיה שמשויכים לביקורת.

כותב הביקורת

מייצג את מחבר הביקורת.

ייצוג JSON 
{
  "profilePhotoUrl": string,
  "displayName": string,
  "isAnonymous": boolean
}
שדות
profilePhotoUrl

string

קישור לתמונת הפרופיל של כותב הביקורת. השדה הזה מאוכלס רק אם הערך של isAnonymous הוא False.
displayName

string

השם של כותב הביקורת. המאפיין הזה יאוכלס בשם האמיתי של כותב הביקורת רק אם הערך של isAnonymous הוא false.
isAnonymous

boolean

מציין אם כותב הביקורת בחר להישאר אנונימי.

StarRating

דירוג בכוכבים מתוך חמישה, כאשר חמישה הוא הדירוג הגבוה ביותר.

טיפוסים בני מנייה (enum)
STAR_RATING_UNSPECIFIED לא צוין.
ONE כוכב אחד מתוך חמישה לכל היותר.
TWO שני כוכבים מתוך חמישה.
THREE שלושה כוכבים מתוך חמישה.
FOUR ארבעה כוכבים מתוך חמישה.
FIVE דירוג הכוכבים המקסימלי.

ReviewReply

מייצג את התשובה של הבעלים או המנהל של המיקום לביקורת.

ייצוג JSON 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State)
}
שדות
comment

string

תוכן התשובה כטקסט פשוט עם תגי עיצוב. האורך המקסימלי הוא 4,096 בייטים.
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של מועד השינוי האחרון בתשובה.

הפורמט הוא RFC 3339, והפלט שנוצר תמיד יהיה בפורמט Z עם 0, 3, 6 או 9 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
reviewReplyState

enum (State)

פלט בלבד. המצב של התשובה לביקורת. פלט בלבד.

מדינה (State)

מייצג את מצב הניהול של תגובה לביקורת.

טיפוסים בני מנייה (enum)
REVIEW_REPLY_STATE_UNSPECIFIED מציין שהמדינה לא צוינה.
PENDING הסמל הזה מציין שהתשובה ממתינה לבדיקה.
REJECTED מציין שהתשובה נדחתה.
APPROVED מסמן שהתשובה אושרה.

ReviewMediaItem

מייצג פריט מדיה (תמונה או סרטון) שמשויך לביקורת.

ייצוג JSON 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
שדות
thumbnailUrl

string

פלט בלבד. כתובת ה-URL של תמונת FIFE של התמונה או של התמונה הממוזערת של הסרטון אם קיים הערך videoUrl.
thumbnailLabel

string

פלט בלבד. תווית שסופקה על ידי היוצר עבור thumbnailUrl.
videoUrl

string

פלט בלבד. כתובת URL של סרטון שאפשר להפעיל.

Methods

deleteReply

 מחיקת התשובה לביקורת שצוינה.

get

 מחזירה את הביקורת שצוינה.

list

 הפונקציה מחזירה את רשימת הביקורות של המיקום שצוין, עם חלוקה לדפים.

updateReply

 מעדכן את התשובה לביקורת שצוינה.