--- title: "POST /reviews/v1beta/{+parent}/productReviews:insert" method: POST path: "/reviews/v1beta/{+parent}/productReviews:insert" tags: ["accounts"] --- # POST /reviews/v1beta/{+parent}/productReviews:insert `POST /reviews/v1beta/{+parent}/productReviews:insert` Inserts a product review. ## Path parameters - `parent` string, required ## Query parameters - `dataSource` string ## Request body - ProductReview — A review for a product. For more information, see [Introduction to Product Review Feeds](https://developers.google.com/product-review-feeds) - `productReviewId` string — Required. The permanent, unique identifier for the product review in the publisher’s system. - `name` string — Identifier. The name of the product review. Format: `"{productreview.name=accounts/{account}/productReviews/{productReview}}"` - `customAttributes` CustomAttribute[] — Optional. A list of custom (merchant-provided) attributes. - `groupValues` CustomAttribute[] — Subattributes within this attribute group. If `group_values` is not empty, `value` must be empty. - `name` string — The name of the attribute. - `value` string — The value of the attribute. If `value` is not empty, `group_values` must be empty. - `dataSource` string — Output only. The primary data source of the product review. - `productReviewStatus` ProductReviewStatus — Product review status. - `lastUpdateTime` string, google-datetime — Output only. Date on which the item has been last updated, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. - `itemLevelIssues` ProductReviewItemLevelIssue[] — Output only. A list of all issues associated with the product review. - `description` string — Output only. A short issue description in English. - `severity` 'SEVERITY_UNSPECIFIED' | 'NOT_IMPACTED' | 'DISAPPROVED' — Output only. How this issue affects serving of the product review. - `reportingContext` 'REPORTING_CONTEXT_ENUM_UNSPECIFIED' | 'SHOPPING_ADS' | 'DISCOVERY_ADS' | 'DEMAND_GEN_ADS' | 'DEMAND_GEN_ADS_DISCOVER_SURFACE' | 'VIDEO_ADS' | 'DISPLAY_ADS' | 'LOCAL_INVENTORY_ADS' | 'VEHICLE_INVENTORY_ADS' | 'FREE_LISTINGS' | 'FREE_LISTINGS_UCP_CHECKOUT' | 'FREE_LOCAL_LISTINGS' | 'FREE_LOCAL_VEHICLE_LISTINGS' | 'YOUTUBE_AFFILIATE' | 'YOUTUBE_SHOPPING' | 'CLOUD_RETAIL' | 'LOCAL_CLOUD_RETAIL' | 'PRODUCT_REVIEWS' | 'MERCHANT_REVIEWS' | 'YOUTUBE_CHECKOUT' — Output only. The reporting context the issue applies to. - `resolution` string — Output only. Whether the issue can be resolved by the merchant. - `code` string — Output only. The error code of the issue. - `documentation` string — Output only. The URL of a web page to help with resolving this issue. - `attribute` string — Output only. The attribute's name, if the issue is caused by a single attribute. - `detail` string — Output only. A detailed issue description in English. - `destinationStatuses` ProductReviewDestinationStatus[] — Output only. The intended destinations for the product review. - `reportingContext` 'REPORTING_CONTEXT_ENUM_UNSPECIFIED' | 'SHOPPING_ADS' | 'DISCOVERY_ADS' | 'DEMAND_GEN_ADS' | 'DEMAND_GEN_ADS_DISCOVER_SURFACE' | 'VIDEO_ADS' | 'DISPLAY_ADS' | 'LOCAL_INVENTORY_ADS' | 'VEHICLE_INVENTORY_ADS' | 'FREE_LISTINGS' | 'FREE_LISTINGS_UCP_CHECKOUT' | 'FREE_LOCAL_LISTINGS' | 'FREE_LOCAL_VEHICLE_LISTINGS' | 'YOUTUBE_AFFILIATE' | 'YOUTUBE_SHOPPING' | 'CLOUD_RETAIL' | 'LOCAL_CLOUD_RETAIL' | 'PRODUCT_REVIEWS' | 'MERCHANT_REVIEWS' | 'YOUTUBE_CHECKOUT' — Output only. The name of the reporting context. - `createTime` string, google-datetime — Output only. Date on which the item has been created, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. - `productReviewAttributes` ProductReviewAttributes — Attributes. - `brands` string[] — Optional. Contains brand names associated with a product. - `maxRating` string, int64 — Optional. The maximum possible number for the rating. The value of the max rating must be greater than the value of the min attribute. - `content` string — Optional. The content of the review. If empty, the content might still get populated from pros and cons. - `minRating` string, int64 — 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. - `skus` string[] — Optional. Contains SKUs (stock keeping units) associated with a product. Often this matches the product Offer Id in the product feed. - `title` string — Optional. The title of the review. - `pros` string[] — Optional. Contains the advantages based on the opinion of the reviewer. Omit boilerplate text like "pro:" unless it was written by the reviewer. - `isSpam` boolean — Optional. Indicates whether the review is marked as spam in the publisher's system. - `reviewCountry` string — Optional. The country of the review defined by ISO 3166-1 Alpha-2 Country Code. - `publisherName` string — 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. - `reviewerId` string — Optional. The author of the product review. A permanent, unique identifier for the author of the review in the publisher's system. - `rating` number, double — Optional. The reviewer's overall rating of the product. - `asins` string[] — Optional. Contains ASINs (Amazon Standard Identification Numbers) associated with a product. - `reviewerUsername` string — Optional. The name of the reviewer of the product review. - `gtins` string[] — Optional. Contains GTINs (global trade item numbers) associated with a product. Sub-types of GTINs (e.g. UPC, EAN, ISBN, JAN) are supported. - `aggregatorName` string — 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. - `collectionMethod` 'COLLECTION_METHOD_UNSPECIFIED' | 'UNSOLICITED' | 'POST_FULFILLMENT' — Optional. The method used to collect the review. - `cons` string[] — Optional. Contains the disadvantages based on the opinion of the reviewer. Omit boilerplate text like "con:" unless it was written by the reviewer. - `productLinks` string[] — Optional. The URI of the product. This URI can have the same value as the `review_link` element, if the review URI and the product URI are the same. - `reviewLanguage` string — Optional. The language of the review defined by BCP-47 language code. - `isVerifiedPurchase` boolean — Optional. Indicates whether the reviewer's purchase is verified. - `reviewerImageLinks` string[] — 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. - `transactionId` string — 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. - `reviewLink` ReviewLink — The URI of the review landing page. - `link` string — Optional. The URI of the review landing page. For example: `http://www.example.com/review_5.html`. - `type` 'TYPE_UNSPECIFIED' | 'SINGLETON' | 'GROUP' — Optional. Type of the review URI. - `reviewTime` string, google-datetime — Required. The timestamp indicating when the review was written. - `subclientName` string — 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. - `publisherFavicon` string — 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. - `isIncentivizedReview` boolean — Optional. Indicates whether the review is incentivized. - `reviewerIsAnonymous` boolean — Optional. Set to true if the reviewer should remain anonymous. - `productNames` string[] — Optional. Descriptive name of a product. - `mpns` string[] — Optional. Contains MPNs (manufacturer part numbers) associated with a product. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/merchantapi.md) · [All operations](https://skmtc.net/google/apis/merchantapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/merchantapi/versions/ef4122adeba1/schema)