REST Resource: accounts.merchantReviews

資源：MerchantReview

商家評論。詳情請參閱「商家評論動態饋給簡介」

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

string

ID。商家評論的名稱。格式："{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

必要欄位。使用者提供商家評論 ID，以識別該商家評論。
attributes

object (MerchantReviewAttributes)

選用設定。商家評論屬性清單。
customAttributes[]

object (CustomAttribute)

必要欄位。自訂 (商家提供) 屬性的清單。您也可以使用這項功能，以泛型形式 (例如 { "name": "size type", "value": "regular" }) 提交資料規格的任何屬性。這項功能可用於提交 API 未明確公開的屬性，例如實驗性屬性。每個自訂屬性的字元數上限為 10240 個 (代表名稱和值的字元總和)。每項產品最多可設定 2500 個自訂屬性，總大小為 102.4 KB。插入自訂屬性名稱時，底線會替換成空格。
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

選用設定。發布商系統中評論作者的永久專屬 ID。
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

 列出商家評論。