ProductAttributes

Product attributes.

Fields
`additional_image_links[]`	`string` Additional URLs of images of the item.
`expiration_date`	`Timestamp` Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date is exposed in `productstatuses` as googleExpirationDate and might be earlier if `expirationDate` is too far in the future.
`disclosure_date`	`Timestamp` 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`	`Timestamp` The day a pre-ordered product becomes available for delivery, in ISO 8601 format.
`gtins[]`	`string` Global Trade Item Numbers ( GTIN ) of the item. You can provide up to 10 GTINs.
`price`	`Price` Price of the item.
`maximum_retail_price`	`Price` Maximum retail price (MRP) of the item. Applicable to India only.
`installment`	`ProductInstallment` Number and amount of installments to pay for an item.
`subscription_cost`	`SubscriptionCost` Number of periods (weeks, months or years) and amount of payment per period for an item with an associated subscription contract.
`loyalty_points`	`LoyaltyPoints` Loyalty points that users receive after purchasing the item. Japan only.
`loyalty_programs[]`	`LoyaltyProgram` 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[]`	`string` Categories of the item (formatted as in product data specification ).
`sale_price`	`Price` Advertised sale price of the item.
`sale_price_effective_date`	`Interval` Date range during which the item is on sale, see product data specification .
`product_height`	`ProductDimension` The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
`product_length`	`ProductDimension` The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
`product_width`	`ProductDimension` The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).
`product_weight`	`ProductWeight` The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).
`shipping[]`	`Shipping` Shipping rules.
`carrier_shipping[]`	`CarrierShipping` Rules for carrier-based shipping.
`free_shipping_threshold[]`	`FreeShippingThreshold` Conditions to be met for a product to have free shipping.
`shipping_weight`	`ShippingWeight` Weight of the item for shipping.
`shipping_length`	`ShippingDimension` Length of the item for shipping.
`shipping_width`	`ShippingDimension` Width of the item for shipping.
`shipping_height`	`ShippingDimension` Height of the item for shipping.
`shipping_handling_business_days[]`	`ShippingBusinessDaysConfig` The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.
`shipping_transit_business_days[]`	`ShippingBusinessDaysConfig` The business days during which orders are in transit. If not provided, Monday to Friday business days will be assumed.
`handling_cutoff_times[]`	`HandlingCutoffTime` The handling cutoff times for shipping.
`size_types[]`	`SizeType` 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 .
`unit_pricing_measure`	`UnitPricingMeasure` The measure and dimension of an item.
`unit_pricing_base_measure`	`UnitPricingBaseMeasure` The preference of the denominator of the unit price.
`ads_labels[]`	`string` Similar to ads_grouping, but only works on CPC.
`cost_of_goods_sold`	`Price` Cost of goods sold. Used for gross profit reporting.
`product_details[]`	`ProductDetail` Technical specification or additional product details.
`product_highlights[]`	`string` Bullet points describing the most relevant product highlights .
`display_ads_similar_ids[]`	`string` Advertiser-specified recommendations. For more information, see Display ads attribute specification .
`promotion_ids[]`	`string` The unique ID of a promotion.
`included_destinations[]`	`DestinationEnum` 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 `excludedDestinations` . 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[]`	`DestinationEnum` 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[]`	`string` 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[]`	`string` 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[]`	`CloudExportAdditionalProperties` Extra fields to export to the Cloud Retail program.
`certifications[]`	`ProductCertification` 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`	`Price` A safeguard in the automated discounts and "Dynamic Promotions" ( https://support.google.com/merchants/answer/13949249 ) projects, ensuring that discounts on business offers do not fall below this value, thereby preserving the offer's value and profitability.
`sustainability_incentives[]`	`ProductSustainabilityIncentive` The list of sustainability incentive programs.
`video_links[]`	`string` Optional. A list of video URLs for the item. Use this attribute to provide more visuals for your product beyond your image attributes. See the Help Center article for more information.
`minimum_order_values[]`	`ProductMinimumOrderValue` The minimum value in the cart before a customer can initiate checkout. Supports multiple minimum order values. Different minimum order values can be specified per country, service and surface. Maximum entries: 100.
`vin`	`string` The Vehicle Identification Number (VIN) of the vehicle.
`model`	`string` The Model of the vehicle, such as `LX` , `EX` , and others.
`trim`	`string` The Trim of the vehicle model, such as `S` , `SV` , `SL` and others.
`body_style`	`VehicleBodyStyle` The body style of the vehicle.
`year`	`int64` The Year of the vehicle model.
`mileage`	`Mileage` The number of miles/kms on the vehicle. See the Mileage for more information.
`electric_range`	`Mileage` The electric range of the vehicle in miles/kms.
`fuel_consumption`	`FuelConsumption` The fuel consumption of the vehicle.
`fuel_consumption_discharged_battery`	`FuelConsumption` The fuel consumption of the vehicle when the hybrid battery is discharged. See the Help Center article for more information.
`energy_consumption`	`EnergyConsumption` The energy consumption of the vehicle.
`co2_emissions`	`Co2Emissions` The co2 emission of the vehicle.
`date_first_registered`	`string` The date the vehicle was first registered. Format: `YYYY-MM` . See the Date first registered for more information.
`engine`	`EngineType` The engine type of the vehicle.
`emissions_standard`	`EmissionsStandard` The emission standard of the vehicle.
`certified_pre_owned`	`bool` Whether the vehicle is OEM certified pre-owned .
`vehicle_msrp`	`Price` The MSRP (Manufacturer Suggested Retail Price) for the vehicle in its current configuration. See the Vehicle MSRP for more information.
`vehicle_all_in_price`	`Price` The all-in advertised price for a vehicle, which includes costs for the following – any accessories attached to the vehicle, environmental levies, extra warranty, fuel, freight, pre-delivery inspection (PDI), dealer fees for handling licensing, provincial regulatory fees, miscellaneous dealer charges for security etching and nitrogen tire fill, and factory-to-customer or dealer-to-customer discounts or incentives. See the Vehicle all-in price for more information.
`vehicle_price_type`	`VehiclePriceType` The price type of the vehicle.
`vehicle_mandatory_inspection_included`	`bool` Whether the vehicle is sold with mandatory inspection and maintenance performed before delivery. See the Vehicle mandatory inspection included for more information.`
`vehicle_expenses`	`Price` The miscellaneous expenses like insurance and registration fees of the vehicle. See the Vehicle expenses for more information.
`warranty`	`Warranty` The warranty of the vehicle.
`returns[]`	`Returns` Optional. Return rules for the product.
`display_address`	`DisplayAddress` The display address of the property.
`neighborhood`	`string` The neighborhood (locality) of the property, such as `Wallingford` , `Greenwood` , etc.
`unit_area`	`UnitArea` The unit area of the property, such as `1000 sqft` .
`property_name`	`string` The name of the property.
`property_type`	`PropertyType` The type of property.
`amenity_feature[]`	`AmenityFeature` The amenity features for the property.
`utilities_included[]`	`UtilitiesIncluded` The utilities included for the property.
`pet_policy`	`PetPolicy` The pet policy for the property.
`specialty_housing_type`	`SpecialtyHousingType` The specialty housing type for the property.
`product_fee[]`	`ProductFee` The product fee for the property.
`lease_term`	`LeaseTerm` The lease term of the property.
`questions_and_answers[]`	`QuestionAndAnswer` Optional. Contains user-, merchant-, and manufacturer-authored questions and answers about the product. Max 30 question and answer pairs. Max 10000 characters total. Each question can have max 1000 characters. Each answer can have max 1000 characters.
`popularity_rank`	`float` Optional. Indicates the popularity of the product in a merchant's inventory. Using a scale of 0.0 (lowest) to 100.0 (highest).
`item_group_title`	`string` Optional. Represents the title of the product group to which this variant product belongs. This can be used along with the item group id attribute. It lets you perform better grouping of variant products, and helps identifying common product characteristics more efficiently.
`document_links[]`	`string` Optional. Contains a list of PDF document URLs for the product. Examples are training manuals, user guides, assembly instructions, package inserts, etc. Must start with "http://" or "https://"), ASCII characters only, and RFC 3986 compliant.
`variant_options[]`	`VariantOption` Optional. Contains the list of all variant-identifying options of this product.
`related_products[]`	`RelatedProduct` Optional. Specifies how other products are related to this product.
`identifier_exists`	`bool` 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`	`bool` 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`	`string` Title of the item.
`description`	`string` Description of the item.
`link`	`string` URL directly linking to your item's page on your online store.
`mobile_link`	`string` URL for the mobile-optimized version of your item's landing page.
`canonical_link`	`string` URL for the canonical version of your item's landing page.
`image_link`	`string` URL of an image of the item.
`adult`	`bool` Set to true if the item is targeted towards adults.
`age_group`	`AgeGroup` Target age group of the item.
`availability`	`Availability` Availability status of the item.
`brand`	`string` Brand of the item. For example, "Google".
`color`	`string` Color of the item. For example, "red".
`condition`	`Condition` Condition or state of the item.
`gender`	`Gender` Target gender of the item.
`google_product_category`	`string` 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`	`string` Shared identifier for all variants of the same product.
`material`	`string` The material of which the item is made. For example, "Leather" or "Cotton".
`mpn`	`string` Manufacturer Part Number ( MPN ) of the item.
`pattern`	`string` The item's pattern . For example, polka dots.
`sell_on_google_quantity`	`int64` The quantity of the product that is available for selling on Google. Supported only for online products.
`max_handling_time`	`int64` Maximal product handling time (in business days).
`min_handling_time`	`int64` Minimal product handling time (in business days).
`shipping_label`	`string` The shipping label of the product, used to group products in account-level shipping rules. Max. 100 characters. For more information, see Shipping label .
`return_policy_label`	`string` The return label of the product, used to group products in account-level return policies. Max. 100 characters. For more information, see Return policy label .
`transit_time_label`	`string` The transit time label of the product, used to group product in account-level transit time tables.
`size`	`string` Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same `itemGroupId` value, see Size .
`size_system`	`SizeSystem` System in which the size is specified. Recommended for apparel items. For more information, see Size system .
`energy_efficiency_class`	`EnergyEfficiencyClass` The energy efficiency class as defined in EU directive 2010/30/EU.
`min_energy_efficiency_class`	`EnergyEfficiencyClass` The energy efficiency class as defined in EU directive 2010/30/EU.
`max_energy_efficiency_class`	`EnergyEfficiencyClass` The energy efficiency class as defined in EU directive 2010/30/EU.
`multipack`	`int64` The number of identical products in a business-defined multipack.
`ads_grouping`	`string` Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise. For more information, see Display ads attribute .
`ads_redirect`	`string` Allows advertisers to override the item URL when the product is shown within the context of Product ads.
`display_ads_id`	`string` An identifier for an item for dynamic remarketing campaigns.
`display_ads_title`	`string` Title of an item for dynamic remarketing campaigns.
`display_ads_link`	`string` URL directly to your item's landing page for dynamic remarketing campaigns.
`display_ads_value`	`double` Offer margin for dynamic remarketing campaigns. For more information, see Display ads attribute .
`pickup_method`	`PickupMethod` The pickup option for the item.
`pickup_sla`	`PickupSla` Item store pickup timeline. For more information, see Pickup SLA .
`pickup_cost`	`PickupCost` Optional. The pickup cost for an item when a customer buys it online and picks it up at a store.
`link_template`	`string` Link template for business hosted local storefront.
`mobile_link_template`	`string` Link template for business hosted local storefront optimized for mobile devices.
`custom_label_0`	`string` Custom label 0 for custom grouping of items in a Shopping campaign.
`custom_label_1`	`string` Custom label 1 for custom grouping of items in a Shopping campaign.
`custom_label_2`	`string` Custom label 2 for custom grouping of items in a Shopping campaign.
`custom_label_3`	`string` Custom label 3 for custom grouping of items in a Shopping campaign.
`custom_label_4`	`string` Custom label 4 for custom grouping of items in a Shopping campaign.
`external_seller_id`	`string` Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.
`pause`	`Pause` Publication of this item will be temporarily paused .
`virtual_model_link`	`string` URL of the 3D image of the item. See the Help Center article for more information.
`structured_title`	`StructuredTitle` Structured title, for algorithmically (AI)-generated titles.
`structured_description`	`StructuredDescription` Structured description, for algorithmically (AI)-generated descriptions.
`latitude`	`double` The latitude of the property. The value must be between -90 (inclusive) and 90 (inclusive), up to 6 decimal places.
`longitude`	`double` The longitude of the property. The value must be between -180 (inclusive) and 180 (inclusive), up to 6 decimal places.
`number_of_units`	`int64` The number of units available for a specific floor plan of the property. The value must be greater than 0.
`number_of_bedrooms`	`double` The number of bedrooms in the property. The value must be greater than or equal to 0 and a multiple of 1.0.
`number_of_bathrooms`	`double` The number of bathrooms in the property. The value must be greater than 0 and a multiple of 0.5.
`short_title`	`string` The short title of the item.

ProductAttributes Stay organized with collections Save and categorize content based on your preferences.

ProductAttributes

ProductAttributes