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)
  }
}
字段
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)

此营业地点的所有者/经理对此评价的回复。

评价者

表示评价的撰写者。

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 表示回复已获批准。

方法

deleteReply

删除对指定评价的回复。

get

返回指定的评价。

list

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

updateReply

更新指定评价的回复。