Attributes
Attributes.
| Fields | |
|---|---|
additional_image_links[]
|
Additional URLs of images of the item. |
expiration_date
|
Date on which the item should expire, as specified upon insertion, in
ISO 8601
format. The actual expiration date is exposed in
|
disclosure_date
|
The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in ISO 8601 format. See Disclosure date for more information. |
availability_date
|
The day a pre-ordered product becomes available for delivery, in ISO 8601 format. |
gtin[]
|
Global Trade Item Numbers ( GTIN ) of the item. You can provide up to 10 GTINs.
Deprecated: Use
|
gtins[]
|
A list of Global Trade Item Numbers ( GTIN ) of the item. You can provide up to 10 GTINs. |
price
|
Price of the item. |
maximum_retail_price
|
Maximum retail price (MRP) of the item. Applicable to India only. |
installment
|
Number and amount of installments to pay for an item. |
subscription_cost
|
Number of periods (weeks, months or years) and amount of payment per period for an item with an associated subscription contract. |
loyalty_points
|
Loyalty points that users receive after purchasing the item. Japan only. |
loyalty_programs[]
|
A list of loyalty program information that is used to surface loyalty benefits (for example, better pricing, points, etc) to the user of this item. |
product_types[]
|
Categories of the item (formatted as in product data specification ). |
sale_price
|
Advertised sale price of the item. |
sale_price_effective_date
|
Date range during which the item is on sale, see product data specification . |
product_height
|
The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
product_length
|
The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
product_width
|
The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive). |
product_weight
|
The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive). |
shipping[]
|
Shipping rules. |
free_shipping_threshold[]
|
Conditions to be met for a product to have free shipping. |
shipping_weight
|
Weight of the item for shipping. |
shipping_length
|
Length of the item for shipping. |
shipping_width
|
Width of the item for shipping. |
shipping_height
|
Height of the item for shipping. |
size_types[]
|
The cut of the item. It can be used to represent combined size types for apparel items. Maximum two of size types can be provided, see Size type . For example, "petite", "plus size". |
taxes[]
|
Tax information. |
unit_pricing_measure
|
The measure and dimension of an item. |
unit_pricing_base_measure
|
The preference of the denominator of the unit price. |
ads_labels[]
|
Similar to ads_grouping, but only works on CPC. |
cost_of_goods_sold
|
Cost of goods sold. Used for gross profit reporting. |
product_details[]
|
Technical specification or additional product details. |
product_highlights[]
|
Bullet points describing the most relevant product highlights . |
display_ads_similar_ids[]
|
Advertiser-specified recommendations. For more information, see Display ads attribute specification . |
promotion_ids[]
|
The unique ID of a promotion. |
included_destinations[]
|
Destinations also known as Marketing methods selections.
The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in
For more information, see Included destination . Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions. |
excluded_destinations[]
|
Destinations also known as Marketing methods selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see Excluded destination . Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions. |
shopping_ads_excluded_countries[]
|
List of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in data source settings. |
lifestyle_image_links[]
|
Additional URLs of lifestyle images of the item, used to explicitly identify images that showcase your item in a real-world context. See the Help Center article for more information. |
cloud_export_additional_properties[]
|
Extra fields to export to the Cloud Retail program. |
certifications[]
|
Product Certifications, for example for energy efficiency labeling of products recorded in the EU EPREL database. See the Help Center article for more information. |
auto_pricing_min_price
|
A safeguard in the automated discounts and "dynamic promotions" projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability. |
sustainability_incentives[]
|
The list of sustainability incentive programs. |
identifier_exists
|
Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided. |
is_bundle
|
Whether the item is a business-defined sub-API. A sub-API is a custom grouping of different products sold by a business for a single price. |
title
|
Title of the item. |
description
|
Description of the item. |
link
|
URL directly linking to your item's page on your online store. |
mobile_link
|
URL for the mobile-optimized version of your item's landing page. |
canonical_link
|
URL for the canonical version of your item's landing page. |
image_link
|
URL of an image of the item. |
adult
|
Set to true if the item is targeted towards adults. |
age_group
|
Target age group of the item. |
availability
|
Availability status of the item. For example, "in_stock" or "out_of_stock". |
brand
|
Brand of the item. For example, "Google". |
color
|
Color of the item. For example, "red". |
condition
|
Condition or state of the item. For example, "new" or "used". |
gender
|
Target gender of the item. For example, "male" or "female". |
google_product_category
|
Google's category of the item (see Google product taxonomy ). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API. |
item_group_id
|
Shared identifier for all variants of the same product. |
material
|
The material of which the item is made. For example, "Leather" or "Cotton". |
mpn
|
Manufacturer Part Number ( MPN ) of the item. |
pattern
|
The item's pattern . For example, polka dots. |
sell_on_google_quantity
|
The quantity of the product that is available for selling on Google. Supported only for online products. |
max_handling_time
|
Maximal product handling time (in business days). |
min_handling_time
|
Minimal product handling time (in business days). |
shipping_label
|
The shipping label of the product, used to group product in account-level shipping rules. |
transit_time_label
|
The transit time label of the product, used to group product in account-level transit time tables. |
size
|
Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same
|
size_system
|
System in which the size is specified. Recommended for apparel items. For example, "US", "UK", "DE". For more information, see Size system . |
tax_category
|
The tax category of the product. |
energy_efficiency_class
|
The energy efficiency class as defined in EU directive 2010/30/EU. |
min_energy_efficiency_class
|
The energy efficiency class as defined in EU directive 2010/30/EU. |
max_energy_efficiency_class
|
The energy efficiency class as defined in EU directive 2010/30/EU. |
multipack
|
The number of identical products in a business-defined multipack. |
ads_grouping
|
Used to group items in an arbitrary way. Only for CPA, discouraged otherwise. For more information, see Display ads attribute . |
ads_redirect
|
Allows advertisers to override the item URL when the product is shown within the context of Product ads. |
display_ads_id
|
An identifier for an item for dynamic remarketing campaigns. |
display_ads_title
|
Title of an item for dynamic remarketing campaigns. |
display_ads_link
|
URL directly to your item's landing page for dynamic remarketing campaigns. |
display_ads_value
|
Offer margin for dynamic remarketing campaigns. For more information, see Display ads attribute . |
pickup_method
|
The pickup option for the item. |
pickup_sla
|
Item store pickup timeline. For more information, see Pickup SLA . |
link_template
|
Link template for business hosted local storefront. |
mobile_link_template
|
Link template for business hosted local storefront optimized for mobile devices. |
custom_label_0
|
Custom label 0 for custom grouping of items in a Shopping campaign. |
custom_label_1
|
Custom label 1 for custom grouping of items in a Shopping campaign. |
custom_label_2
|
Custom label 2 for custom grouping of items in a Shopping campaign. |
custom_label_3
|
Custom label 3 for custom grouping of items in a Shopping campaign. |
custom_label_4
|
Custom label 4 for custom grouping of items in a Shopping campaign. |
external_seller_id
|
Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account. |
pause
|
Publication of this item will be temporarily paused . |
virtual_model_link
|
URL of the 3D image of the item. See the Help Center article for more information. |
structured_title
|
Structured title, for algorithmically (AI)-generated titles. |
structured_description
|
Structured description, for algorithmically (AI)-generated descriptions. |