REST Resource: accounts.locations.reviews

资源：Review

仅限输出。表示对营业地点的评价。

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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

共 5 个星级，其中 5 星为最高星级。

枚举
STAR_RATING_UNSPECIFIED 未指定。
ONE 1 星（最高 5 星）。
TWO 2 星（最高 5 星）。
THREE 3 星（最高 5 星）。
FOUR 4 星（最高 5 星）。
FIVE 最高星级。

ReviewReply

表示营业地点的所有者/管理员对评价的回复。

JSON 表示法 
{
  "comment": string,
  "updateTime": string,
  "reviewReplyState": enum (State)
}
字段
comment

string

回复正文是带标记的纯文本。回复的最大长度为 4096 字节。
updateTime

string (Timestamp format)

仅限输出。上次修改回复时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 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)

仅限输出。评价回复的状态。仅限输出。

州

表示评价回复的审核状态。

枚举
REVIEW_REPLY_STATE_UNSPECIFIED 表示状态未指定。
PENDING 表示回复待审核。
REJECTED 表示回复已被拒绝。
APPROVED 表示回复已获批准。

ReviewMediaItem

表示与评价相关联的媒体内容（照片或视频）。

JSON 表示法 
{
  "thumbnailUrl": string,
  "thumbnailLabel": string,
  "videoUrl": string
}
字段
thumbnailUrl

string

仅限输出。照片的 FIFE 网址，如果存在 videoUrl，则为视频缩略图的 FIFE 网址。
thumbnailLabel

string

仅限输出。作者为 thumbnailUrl 提供的标签。
videoUrl

string

仅限输出。可播放的视频网址。

方法

deleteReply

 删除对指定评价的回复。

get

 返回指定的评价。

list

 返回指定营业地点的分页评价列表。

updateReply

 更新指定评价的回复。