Resource: Product
The processed product, built from multiple product inputs
after applying rules and supplemental data sources. This processed product matches what is shown in your Merchant Center account and in Shopping ads and other surfaces across Google. Each product is built from exactly one primary data source product input, and multiple supplemental data source inputs. After inserting, updating, or deleting a product input, it may take several minutes before the updated processed product can be retrieved.
All fields in the processed product and its sub-messages match the name of their corresponding attribute in the Product data specification with some exceptions.
JSON representation |
---|
{ "name": string, "channel": enum ( |
Fields | |
---|---|
name |
The name of the product. Format: |
channel |
Output only. The channel of the product. |
offer |
Output only. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the product data specification for details. |
content |
Output only. The two-letter ISO 639-1 language code for the product. |
feed |
Output only. The feed label for the product. |
data |
Output only. The primary data source of the product. |
attributes |
Output only. A list of product attributes. |
custom |
Output only. A list of custom (merchant-provided) attributes. It can also be used to submit any attribute of the data specification in its generic form (for example, |
product |
Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously. |
version |
Output only. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time. If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current Only supported for insertions into primary data sources. If the operation is prevented, the aborted exception will be thrown. |
ProductStatus
The status of a product, data validation issues, that is, information about a product computed asynchronously.
JSON representation |
---|
{ "destinationStatuses": [ { object ( |
Fields | |
---|---|
destination |
The intended destinations for the product. |
item |
A list of all issues associated with the product. |
creation |
Date on which the item has been created, in ISO 8601 format. |
last |
Date on which the item has been last updated, in ISO 8601 format. |
google |
Date on which the item expires, in ISO 8601 format. |
DestinationStatus
The destination status of the product status.
JSON representation |
---|
{
"reportingContext": enum ( |
Fields | |
---|---|
reporting |
The name of the reporting context. |
approved |
List of country codes (ISO 3166-1 alpha-2) where the offer is approved. |
pending |
List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval. |
disapproved |
List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved. |
ItemLevelIssue
The ItemLevelIssue of the product status.
JSON representation |
---|
{ "code": string, "severity": enum ( |
Fields | |
---|---|
code |
The error code of the issue. |
severity |
How this issue affects serving of the offer. |
resolution |
Whether the issue can be resolved by the merchant. |
attribute |
The attribute's name, if the issue is caused by a single attribute. |
reporting |
The reporting context the issue applies to. |
description |
A short issue description in English. |
detail |
A detailed issue description in English. |
documentation |
The URL of a web page to help with resolving this issue. |
applicable |
List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer. |
Severity
How the issue affects the serving of the product.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
Not specified. |
NOT_IMPACTED |
This issue represents a warning and does not have a direct affect on the product. |
DEMOTED |
The product is demoted and most likely have limited performance in search results |
DISAPPROVED |
Issue disapproves the product. |
Methods |
|
---|---|
|
Retrieves the processed product from your Merchant Center account. |
|
Lists the processed products in your Merchant Center account. |