REST Resource: accounts.productReviews

资源：ProductReview

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

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

string

标识符。商品评价的名称。格式："{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

必需。发布商系统中商品评价的永久唯一标识符。
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

可选。基于评价者的意见包含劣势。除非是评价者撰写的，否则请省略“缺点：”等样本文字。
productNames[]

string

可选。商品的描述性名称。
asins[]

string

可选。包含与商品关联的 ASIN（Amazon 标准识别号）。
gtins[]

string

可选。包含与商品关联的 GTIN（全球贸易项目代码）。支持 GTIN 的子类型（例如 UPC、EAN、ISBN、JAN）。
mpns[]

string

可选。包含与商品关联的 MPN（制造商部件号）。
skus[]

string

可选。包含与商品关联的 SKU（库存单元）。此 ID 通常与商品 Feed 中的商品优惠 ID 一致。
brands[]

string

可选。包含与商品相关联的品牌名称。
collectionMethod

enum (CollectionMethod)

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

string

可选。与发布商系统中与评价相关联的交易的永久唯一标识符。此 ID 可用于指明多条评价与同一笔交易相关联。
aggregatorName

string

可选。商品评价集合商家的名称。

发布商可以通过评价集合商家来管理评价并提供 Feed。此元素表示使用了聚合器，并包含聚合器的相关信息。
subclientName

string

可选。商品评价对应的子客户的名称。

子客户端是商品评价来源的标识符。它应与文件数据源路径中提供的目录相同。
publisherName

string

可选。商品评价发布商的名称。

发布者的相关信息，发布者可能是零售商、制造商、评价服务公司或发布商品评价的任何实体。
publisherFavicon

string

可选。指向发布商公司 favicon 的链接。图片尺寸应为 favicon 大小：16 x 16 像素。图片格式应为 GIF、JPG 或 PNG。
reviewerId

string

可选。商品评价的作者。

评价作者在发布商系统中的永久唯一标识符。
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)

可选。评分的可能最大值。最高分级的值必须大于最小分级属性的值。
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

 列出商品评价。