REST Resource: accounts.productReviews

資源：ProductReview

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

JSON 表示法 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
欄位
name

string

ID。產品評論的名稱。格式："{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

必要欄位。發布商系統中產品評論的永久專屬 ID。
attributes

object (ProductReviewAttributes)

選用設定。產品評論屬性清單。
customAttributes[]

object (CustomAttribute)

選用設定。自訂 (商家提供) 屬性清單。
dataSource

string

僅供輸出。產品評論的主要資料來源。
productReviewStatus

object (ProductReviewStatus)

僅供輸出。產品評論的狀態、資料驗證問題，也就是非同步計算的產品評論相關資訊。

ProductReviewAttributes

屬性。

JSON 表示法 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
欄位
reviewTime

string (Timestamp format)

必要欄位。指示評論撰寫時間的時間戳記。
pros[]

string

選用設定。包含評論者認為的優點。省略樣板文字，例如「pro:」。
cons[]

string

選用設定。根據評論者意見，列出產品的缺點。除非評論者有寫下「con:」，否則請省略「con:」等樣板文字。
productNames[]

string

選用設定。產品的描述性名稱。
asins[]

string

選用設定。包含與產品相關聯的 ASIN (Amazon Standard Identification Numbers)。
gtins[]

string

選用設定。包含與產品相關聯的全球交易品項識別碼 (GTIN)。系統支援全球交易品項識別碼子類型 (例如通用產品代碼、EAN、ISBN、JAN)。
mpns[]

string

選用設定。內含與產品相關聯的製造商零件編號 (製造商零件編號)。
skus[]

string

選用設定。包含與產品相關聯的 SKU (存貨單位)。這個值通常會與產品動態饋給中的產品 Offer ID 相符。
brands[]

string

選用設定。包含與產品相關聯的品牌名稱。
collectionMethod

enum (CollectionMethod)

選用設定。用於收集評論的方法。
transactionId

string

選用設定。發布商系統中與評論相關聯的交易專屬 ID。這個 ID 可用來表示多則評論與同筆交易相關。
aggregatorName

string

選用設定。產品評論匯集工具的名稱。

發布商可以使用評論集結網站來管理評論，並提供動態饋給。這個元素指出使用集結網站，且包含集結網站的相關資訊。
subclientName

string

選用設定。產品評論的子客戶名稱。

子客戶是產品評論來源的 ID。應與檔案資料來源路徑中提供的目錄相同。
publisherName

string

選用設定。產品評論發布者的名稱。

發布商的資訊，可能是零售商、製造商、評論服務公司，或任何發布產品評論實體。
publisherFavicon

string

選用設定。發布商公司 favicon 的連結。圖片尺寸應為 favicon 大小：16 x 16 像素。圖片格式應為 GIF、JPG 或 PNG。
reviewerId

string

選用設定。產品評論的作者。

發布商系統中評論作者的永久專屬 ID。
reviewerIsAnonymous

boolean

選用設定。如果評論者保持匿名，則設為 true。
reviewerUsername

string

選用設定。產品評論的評論者名稱。
reviewLanguage

string

選用設定。評論的語言，由 BCP-47 語言代碼定義。
reviewCountry

string

選用設定。根據 ISO 3166-1 Alpha-2 國家/地區代碼定義的評論國家/地區。
title

string

選用設定。評論的標題。
content

string

必要欄位。評論內容。
minRating

string (int64 format)

選用設定。包含該評論的相關評分。評分的最小可能數字。這應該是最差的評分，不應做為「無評分」的值。
maxRating

string (int64 format)

選用設定。評分的最高數字。max 屬性的值必須大於 min 屬性的值。
rating

number

選用設定。評論者對產品的整體評分。
isSpam

boolean

選用設定。指出評論是否在發布商系統中標示為垃圾內容。

類型

評論 URI 的類型。

列舉
TYPE_UNSPECIFIED 未指定類型。
SINGLETON 評論頁面只包含這一則評論。
GROUP 評論頁面包含一組評論，其中包括這則評論。

CollectionMethod

用於收集評論的方法。

列舉
COLLECTION_METHOD_UNSPECIFIED 未指定收集方法。
UNSOLICITED 使用者提交評論時，並未回應特定招攬行為。
POST_FULFILLMENT 使用者在訂單完成後，回應邀請提交評論。

ProductReviewStatus

產品審查狀態。

JSON 表示法 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
欄位
destinationStatuses[]

object (ProductReviewDestinationStatus)

僅供輸出。產品評論的預定目的地。
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

僅供輸出。列出產品評論相關問題的所有問題。
createTime

string (Timestamp format)

僅供輸出。項目的建立日期 (採用 ISO 8601 格式)。
lastUpdateTime

string (Timestamp format)

僅供輸出。項目上次更新的日期，採用 ISO 8601 格式。

ProductReviewDestinationStatus

產品審查狀態的目的地狀態。

JSON 表示法 
{
  "reportingContext": enum (ReportingContextEnum)
}
欄位
reportingContext

enum (ReportingContextEnum)

僅供輸出。報表內容名稱。

ProductReviewItemLevelIssue

產品審查狀態的 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

 插入產品評論。

list

 列出產品評論。