REST Resource: accounts.merchantReviews

资源：MerchantReview

对商家的评价。如需了解详情，请参阅商家评价 Feed 简介

JSON 表示法 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
字段
name

string

标识符。商家评价的名称。格式："{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

必需。用户提供的商家评价 ID，用于唯一标识商家评价。
attributes

object (MerchantReviewAttributes)

可选。商家评价属性列表。
customAttributes[]

object (CustomAttribute)

必需。自定义（商家提供的）属性列表。它还可用于以通用形式（例如 { "name": "size type", "value": "regular" }）提交数据规范的任何属性。这对于提交 API 未明确公开的属性（例如实验性属性）非常有用。每个自定义属性允许的字符数上限为 10240 个（表示名称和值的字符数总和）。每个商品最多可设置 2500 个自定义属性，总大小不得超过 102.4KB。自定义属性名称中的下划线会在插入时替换为空格。
dataSource

string

仅限输出。商家评价的主要数据源。
merchantReviewStatus

object (MerchantReviewStatus)

仅限输出。商家评价的状态、数据验证问题，即异步计算的商家评价相关信息。

MerchantReviewAttributes

属性。

JSON 表示法 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
字段
merchantId

string

必需。在所有请求中都必须唯一且稳定。换句话说，如果今天的请求和 90 天前的请求都涉及同一商家，则它们必须具有相同的 ID。
merchantDisplayName

string

可选。商家的直观易懂的显示名称。
minRating

string (int64 format)

可选。可能的最小评分数字。这应是最差的评分，不应为无评分值。
maxRating

string (int64 format)

可选。评分的可能最大值。最高评分值必须大于最低评分值。
rating

number

可选。评价者对商家的总体评分。
title

string

可选。评价的标题。
content

string

必需。这应为用户提供的任何自由形式文本，且不得截断。如果针对不同的问题提供了多个回答，则应包含所有回答，并提供最少的上下文，以便回答清晰明了。如果问题未得到解答，请勿提供背景信息。
reviewerId

string

可选。评价作者在发布商系统中永久的唯一标识符。
reviewerUsername

string

可选。评价作者的显示名称。
isAnonymous

boolean

可选。如果评价者应保持匿名，请将其设置为 true。
collectionMethod

enum (CollectionMethod)

可选。用于收集评价的方法。
reviewTime

string (Timestamp format)

必需。指示撰写评价时的时间戳。
reviewLanguage

string

必需。由 BCP-47 语言代码定义的评价语言。
reviewCountry

string

可选。评价者下单时所在的国家/地区（以 ISO 3166-1 Alpha-2 国家/地区代码定义）。

CollectionMethod

用于收集评价的方法。

枚举
COLLECTION_METHOD_UNSPECIFIED 未指定收集方法。
MERCHANT_UNSOLICITED 用户提交评价时并未针对特定邀请做出回应。
POINT_OF_SALE 用户在下单时针对邀请提交了评价。
AFTER_FULFILLMENT 用户在订单履单后，应邀请提交了评价。

MerchantReviewStatus

商家评价的状态、数据验证问题，即异步计算的商家评价相关信息。

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (MerchantReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (MerchantReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
字段
destinationStatuses[]

object (MerchantReviewDestinationStatus)

仅限输出。商家评价的目标平台。
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

仅限输出。与商家审核相关的所有问题的列表。
createTime

string (Timestamp format)

仅限输出。商品的创建日期，采用 ISO 8601 格式。
lastUpdateTime

string (Timestamp format)

仅限输出。商品的上次更新日期，采用 ISO 8601 格式。

MerchantReviewDestinationStatus

商家审核状态的目的地状态。

JSON 表示法 
{
  "reportingContext": enum (ReportingContextEnum)
}
字段
reportingContext

enum (ReportingContextEnum)

仅限输出。报告上下文的名称。

MerchantReviewItemLevelIssue

商家审核状态的 ItemLevelIssue。

JSON 表示法 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string
}
字段
code

string

仅限输出。问题的错误代码。
severity

enum (Severity)

仅限输出。此问题对商家评价的展示有何影响。
resolution

string

仅限输出。商家是否可以解决此问题。
attribute

string

仅限输出。属性的名称（如果此问题是由单个属性引发的）。
reportingContext

enum (ReportingContextEnum)

仅限输出。问题适用的报告上下文。
description

string

仅限输出。以英文编写的简短问题说明。
detail

string

仅限输出。以英文编写的详细问题说明。
documentation

string

仅限输出。帮助解决此问题的网页的网址。

严重程度

此问题对商家评价的展示有何影响。

枚举
SEVERITY_UNSPECIFIED 未指定。
NOT_IMPACTED 此问题属于警告，不会直接影响商家审核。
DISAPPROVED 问题导致商家评价遭拒。

方法

delete

 删除商家评价。

get

 获取商家评价。

insert

 为您的 Merchant Center 账号插入评价。

list

 列出商家评价。