- Resource: ProductReview
- ProductReviewAttributes
- ReviewLink
- Type
- CollectionMethod
- ProductReviewStatus
- ProductReviewDestinationStatus
- ProductReviewItemLevelIssue
- Severity
- Methods
Resource: ProductReview
A review for a product. For more information, see Introduction to Product Review Feeds
JSON representation |
---|
{ "name": string, "productReviewId": string, "attributes": { object ( |
Fields | |
---|---|
name |
Identifier. The name of the product review. Format: |
product |
Required. The permanent, unique identifier for the product review in the publisher’s system. |
attributes |
Optional. A list of product review attributes. |
custom |
Optional. A list of custom (merchant-provided) attributes. |
data |
Output only. The primary data source of the product review. |
product |
Output only. The status of a product review, data validation issues, that is, information about a product review computed asynchronously. |
ProductReviewAttributes
Attributes.
JSON representation |
---|
{ "reviewTime": string, "pros": [ string ], "cons": [ string ], "reviewLink": { object ( |
Fields | |
---|---|
review |
Required. The timestamp indicating when the review was written. |
pros[] |
Optional. Contains the advantages based on the opinion of the reviewer. Omit boilerplate text like "pro:" unless it was written by the reviewer. |
cons[] |
Optional. Contains the disadvantages based on the opinion of the reviewer. Omit boilerplate text like "con:" unless it was written by the reviewer. |
review |
Optional. The URI of the review landing page. |
reviewer |
Optional. A URI to an image of the reviewed product created by the review author. The URI does not have to end with an image file extension. |
product |
Optional. Descriptive name of a product. |
product |
Optional. The URI of the product. This URI can have the same value as the |
asins[] |
Optional. Contains ASINs (Amazon Standard Identification Numbers) associated with a product. |
gtins[] |
Optional. Contains GTINs (global trade item numbers) associated with a product. Sub-types of GTINs (e.g. UPC, EAN, ISBN, JAN) are supported. |
mpns[] |
Optional. Contains MPNs (manufacturer part numbers) associated with a product. |
skus[] |
Optional. Contains SKUs (stock keeping units) associated with a product. Often this matches the product Offer Id in the product feed. |
brands[] |
Optional. Contains brand names associated with a product. |
collection |
Optional. The method used to collect the review. |
transaction |
Optional. A permanent, unique identifier for the transaction associated with the review in the publisher's system. This ID can be used to indicate that multiple reviews are associated with the same transaction. |
aggregator |
Optional. The name of the aggregator of the product reviews. A publisher may use a reviews aggregator to manage reviews and provide the feeds. This element indicates the use of an aggregator and contains information about the aggregator. |
subclient |
Optional. The name of the subclient of the product reviews. The subclient is an identifier of the product review source. It should be equivalent to the directory provided in the file data source path. |
publisher |
Optional. The name of the publisher of the product reviews. The information about the publisher, which may be a retailer, manufacturer, reviews service company, or any entity that publishes product reviews. |
publisher |
Optional. A link to the company favicon of the publisher. The image dimensions should be favicon size: 16x16 pixels. The image format should be GIF, JPG or PNG. |
reviewer |
Optional. The author of the product review. A permanent, unique identifier for the author of the review in the publisher's system. |
reviewer |
Optional. Set to true if the reviewer should remain anonymous. |
reviewer |
Optional. The name of the reviewer of the product review. |
review |
Optional. The language of the review defined by BCP-47 language code. |
review |
Optional. The country of the review defined by ISO 3166-1 Alpha-2 Country Code. |
title |
Optional. The title of the review. |
content |
Required. The content of the review. |
min |
Optional. Contains the ratings associated with the review. The minimum possible number for the rating. This should be the worst possible rating and should not be a value for no rating. |
max |
Optional. The maximum possible number for the rating. The value of the max rating must be greater than the value of the min attribute. |
rating |
Optional. The reviewer's overall rating of the product. |
is |
Optional. Indicates whether the review is marked as spam in the publisher's system. |
ReviewLink
The URI of the review landing page.
JSON representation |
---|
{
"type": enum ( |
Fields | |
---|---|
type |
Optional. Type of the review URI. |
link |
Optional. The URI of the review landing page. For example: |
Type
Type of the review URI.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Type unspecified. |
SINGLETON |
The review page contains only this single review. |
GROUP |
The review page contains a group of reviews including this review. |
CollectionMethod
The method used to collect the review.
Enums | |
---|---|
COLLECTION_METHOD_UNSPECIFIED |
Collection method unspecified. |
UNSOLICITED |
The user was not responding to a specific solicitation when they submitted the review. |
POST_FULFILLMENT |
The user submitted the review in response to a solicitation after fulfillment of the user's order. |
ProductReviewStatus
Product review status.
JSON representation |
---|
{ "destinationStatuses": [ { object ( |
Fields | |
---|---|
destination |
Output only. The intended destinations for the product review. |
item |
Output only. A list of all issues associated with the product review. |
create |
Output only. Date on which the item has been created, in ISO 8601 format. |
last |
Output only. Date on which the item has been last updated, in ISO 8601 format. |
ProductReviewDestinationStatus
The destination status of the product review status.
JSON representation |
---|
{
"reportingContext": enum ( |
Fields | |
---|---|
reporting |
Output only. The name of the reporting context. |
ProductReviewItemLevelIssue
The ItemLevelIssue of the product review status.
JSON representation |
---|
{ "code": string, "severity": enum ( |
Fields | |
---|---|
code |
Output only. The error code of the issue. |
severity |
Output only. How this issue affects serving of the product review. |
resolution |
Output only. Whether the issue can be resolved by the merchant. |
attribute |
Output only. The attribute's name, if the issue is caused by a single attribute. |
reporting |
Output only. The reporting context the issue applies to. |
description |
Output only. A short issue description in English. |
detail |
Output only. A detailed issue description in English. |
documentation |
Output only. The URL of a web page to help with resolving this issue. |
Severity
How the issue affects the serving of the product review.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
Not specified. |
NOT_IMPACTED |
This issue represents a warning and does not have a direct affect on the product review. |
DISAPPROVED |
Issue disapproves the product review. |
Methods |
|
---|---|
|
Deletes a product review. |
|
Gets a product review. |
|
Inserts a product review. |
|
Lists product reviews. |