Product

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. 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.

Fields
name

string

The name of the product. Format: accounts/{account}/products/{product} where the last section product consists of: content_language~feed_label~offer_id example for product name is accounts/123/products/en~US~sku123 . A legacy local product name would be accounts/123/products/local~en~US~sku123 . Note: For calls to the v1beta version, the product section consists of: channel~content_language~feed_label~offer_id , for example: accounts/123/products/online~en~US~sku123 .

base64_encoded_name

string

Output only. The unpadded base64url encoded name of the product. Format: accounts/{account}/products/{product} where the last section product is the unpadded base64url encoding of the content_language~feed_label~offer_id name. Example: accounts/123/products/ZW5-VVN-c2t1LzEyMw for the decoded product name accounts/123/products/en~US~sku/123 . This field can be used directly as input to the API methods that require the product name to be encoded if it contains special characters, for example GetProduct .

legacy_local

bool

Output only. Determines whether the product is only targeting local destinations and whether the product name should be distinguished with a local~ prefix. For example, accounts/123/products/local~en~US~sku123 .

offer_id

string

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_language

string

Output only. The two-letter ISO 639-1 language code for the product.

feed_label

string

Output only. The feed label lets you categorize and identify your products. The maximum allowed characters is 20 and the supported characters are A-Z , 0-9 , hyphen and underscore. The feed label must not include any spaces. For more information, see Using feed labels

data_source

string

Output only. The primary data source of the product.

product_attributes

ProductAttributes

Output only. A list of strongly-typed product attributes.

custom_attributes[]

CustomAttribute

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, { "name": "size type", "value": "regular" } ). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google.

product_status

ProductStatus

Output only. The status of a product, data validation issues, that is, information about a product computed asynchronously.

automated_discounts

AutomatedDiscounts

Output only. The automated discounts information for the product.

archived

bool

Output only. Determines whether the product is archived .

To archive or restore your product, visit Merchant Center products page. Learn also more about offer visibility .

version_number

int64

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 version_number .

Only supported for insertions into primary data sources.

If the operation is prevented, the aborted exception will be thrown.