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),
  "policyViolation": enum (PolicyViolation)
}
字段
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)

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

enum (PolicyViolation)

可选。仅限输出。导致拒绝的违规问题。仅当 reviewReplyState 为 REJECTED 时填充。

州

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

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

PolicyViolation

表示标准化政策违规。未来可能会添加新值。客户端应准备好处理未知值。

枚举
POLICY_VIOLATION_UNSPECIFIED 表示未指定的政策违规行为。
ACCOUNT_RESTRICTED_AND_SUSPENDED 与此商家资料相关联的 Google 账号已被限制，导致相应商家资料被中止。
ACCOUNT_RESTRICTED_AND_EDIT_REJECTED 与此商家资料相关联的 Google 账号已被限制，导致修改被拒绝。与 ACCOUNT_RESTRICTED_AND_SUSPENDED 不同，商家资料本身仍处于有效状态，并未被中止。
ASSOCIATED_ACCOUNT_SUSPENDED 与此商家资料相关联的 Google 账号信誉不佳。与此账号相关联的商家资料已被中止。
BUSINESS_INELIGIBLE 您的商家不符合使用商家资料的条件。
OWNERSHIP_REVOKED 另一个 Google 账号已声明此商家资料的所有权。您无法再管理此商家资料。
LOCATION_SUSPENDED 此商家资料已被中止。
LOCATION_DISABLED 此商家资料已被停用。
LOCATION_VERIFICATION_REQUIRED 此商家资料未经过验证。
PO_BOX 由于您的商家地址不能是邮政信箱，因此您的商家资料已被中止。
GOOGLE_PAY_SUSPENSION 与您的支付资料相关联的商家资料已被中止。
EDITING_RESTRICTION 此商家资料目前无法接收公开更新。Google 已关闭此地点的修改功能，以防止出现违反政策的内容。
ILLEGAL_BUSINESS_HOURS_EDIT 您所属的业务类别无法修改营业时间。
FAKE_ENGAGEMENT 发布的内容不得违反虚假互动相关政策。虚假互动包括诱导性内容、意在操控地点评分的内容，以及其他不代表真实体验的内容。
ADULT_THEMED 发布的内容不得违反成人主题内容相关政策。成人主题内容包括非露骨的色情内容或其他成人内容。
SEXUALLY_EXPLICIT 发布的内容不得违反露骨色情内容相关政策。露骨色情内容包括裸露生殖器或对性行为的描绘或描述。
ADVERTISING_AND_SOLICITATION 发布的内容不得违反宣传或招揽相关政策。宣传和招揽内容包括宣传性或商业内容，或为换取利益而发布的内容。
DANGEROUS 发布的内容不得违反危险内容相关政策。危险内容会宣扬、助长或鼓励有害行为。
GIBBERISH_AND_REPETITIVE 发布的内容不得违反内容不清楚或重复内容相关政策。内容不清楚或重复内容会弱化其他人可在 Google 上找到的实用信息。
REPETITIVE 发布的内容不得违反重复内容相关政策。重复内容包括使用一个或多个账号多次添加相同或类似内容。
UNCLEAR 发布的内容不得违反内容不清楚相关政策。不清楚的内容包括随机字符或其他无意义的内容。
ILLEGAL 发布的内容不得违反非法内容相关政策。
OFF_TOPIC 发布的内容不得违反偏离主题的内容相关政策。偏离主题的内容包括一般性、政治性或社会性评论，以及与他人打口水仗。
OFFENSIVE 发布的内容不得违反冒犯性内容相关政策。冒犯性内容可能有合理理由导致他人极度愤怒或感到被侮辱、不被尊重。
VIOLENCE_AND_GORE 发布的内容不得违反暴力和血腥内容相关政策。暴力和血腥内容包括涉及人或动物的极端内容，此类内容描绘真实的暴力行为、血腥画面、身体部位或内脏。
CHILD_SAFETY 发布的内容不得违反儿童安全相关政策。给儿童带来危险、剥削或虐待儿童，或者利用 Google 服务危害儿童的题材都属于违规内容。
HARASSMENT 发布的内容不得违反骚扰相关政策。欺凌、威胁、色情化或导致用户担心自身安全的内容都属于违规内容。
HATE_SPEECH 发布的内容不得违反仇恨言论相关政策。仇恨言论包括基于受保护的特征或者与制度性歧视/边缘化相关的其他特征宣扬或纵容暴力、歧视、诋毁或煽动仇恨。
IMPERSONATION 发布的内容不得违反冒充别人相关政策。冒充别人包括为了误导他人或获取不正当利益而使用虚假身份。
MISINFORMATION 发布的内容不得违反虚假信息相关政策。虚假信息包括可能对个人、企业或社会造成严重伤害的虚假或不准确的信息。
MISREPRESENTATION 发布的内容不得违反虚假陈述相关政策。虚假陈述包括为获得不正当利益而进行的误导性陈述或遗漏。
OBSCENITY_AND_PROFANITY 发布的内容不得违反淫秽或亵渎性内容相关政策。淫秽和亵渎性内容包括在当地被认为具有社会攻击性或粗俗的用语或手势。
PERSONAL_INFO 发布的内容不得违反个人信息相关政策。个人信息包括私密信息或机密信息，例如信用卡信息、医疗记录或政府核发的身份信息（无论是您自己的还是他人的）。
REGULATED_GOODS_AND_SERVICES 发布的内容不得违反管制商品和服务相关政策。为销售当地法规所管制产品或服务而制作的号召性用语或优惠信息也属于违规内容。
GENERIC_VANDALISM 发布的内容不得违反滥用内容或低质量内容相关政策。
GENERIC_FRAUD 发布的内容不得违反欺骗性内容和行为相关政策。欺骗性内容会故意误导或欺骗其他用户。
PHOTOS_AND_VIDEOS_CRITERIA 发布的内容不得违反照片和视频标准。
MODERATION_ERROR 处理您的内容时出错。
PRIVACY 发布的内容不得违反 Google 地图用户提供的内容隐私权政策。
GENERIC_VIOLATION 您的内容违反了我们的政策，因此不允许发布。
GENERIC_QUALITY 发布的内容不得违反低质量内容相关政策。
IDENTITY_CHANGE 您所做的更改与创建的商家有很大不同。这违反了我们的政策。
GEOGRAPHIC_LOCATION_CHANGE 表示自商家资料创建以来，商家的实际地理位置（地址或纬度/经度）发生了显著变化。

ReviewMediaItem

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

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

string

仅限输出。照片或视频缩略图的 FIFE 网址（如果存在 videoUrl）。
thumbnailLabel

string

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

string

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

方法

deleteReply

 删除对指定评价的回复。

get

 返回指定的评价。

list

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

updateReply

 更新指定评价的回复。