Google Content for Shopping: Most-used fields

The table below gives information about most-used fields that you can import from Google Content for Shopping. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Date	Date	The date when the product data was collected by the platform.	dimension
additionalImageLinks.{NUM}	additionalImageLinks.{NUM}	Additional URLs of images for the product.	dimension
adsGrouping	adsGrouping	A custom grouping for items in Product Ads, allowing arbitrary grouping.	dimension
adsLabels.{NUM}	adsLabels.{NUM}	Labels used for grouping items in Product Ads, specifically for CPC campaigns.	dimension
adsRedirect	adsRedirect	An override URL for the item when shown in Product Ads.	dimension
adult	adult	Indicates if the product is targeted towards adults.	dimension
ageGroup	ageGroup	The target age group for the item, e.g., ‘newborn’, ‘infant’, ‘toddler’, ‘kids’, ‘adult’.	dimension
availability	availability	The current availability status of the product, e.g., ‘in stock’, ‘out of stock’, ‘preorder’.	dimension
availabilityDate	availabilityDate	The date when the product becomes available for purchase.	dimension
brand	brand	The brand name of the product.	dimension
canonicalLink	canonicalLink	The URL for the canonical version of your item’s landing page.	dimension
certifications.{NUM}.certificationAuthority	certifications.{NUM}.certificationAuthority	The authority that issued the product certification.	dimension
certifications.{NUM}.certificationCode	certifications.{NUM}.certificationCode	The code or number associated with the product certification.	metric
certifications.{NUM}.certificationName	certifications.{NUM}.certificationName	The name of the product certification, e.g., for energy efficiency labeling.	dimension
channel	channel	The channel through which the product is sold, e.g., ‘online’ or ‘local’.	dimension
color	color	The color of the product.	dimension
condition	condition	The condition or state of the product, e.g., ‘new’, ‘refurbished’, ‘used’.	dimension
contentLanguage	contentLanguage	The two-letter ISO 639-1 language code for the content.	dimension
costOfGoodsSold.currency	costOfGoodsSold.currency	The currency of the cost of goods sold, used for gross profit reporting.	dimension
costOfGoodsSold.value	costOfGoodsSold.value	The numerical value of the cost of goods sold, used for gross profit reporting.	metric
creationDate	creationDate	The date and time when the product was created, in ISO 8601 format.	dimension
customAttributes.{NUM}.groupValues.{NUM}.name	customAttributes.{NUM}.groupValues.{NUM}.name	The name of a custom (merchant-provided) attribute within a group of values.	dimension
customAttributes.{NUM}.groupValues.{NUM}.value	customAttributes.{NUM}.groupValues.{NUM}.value	The value of a custom (merchant-provided) attribute within a group of values.	metric
customAttributes.{NUM}.name	customAttributes.{NUM}.name	The name of a custom attribute defined by the merchant.	dimension
customAttributes.{NUM}.value	customAttributes.{NUM}.value	The value associated with a custom attribute defined by the merchant.	dimension
customLabel0	customLabel0	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel1	customLabel1	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel2	customLabel2	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel3	customLabel3	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
customLabel4	customLabel4	A custom label (0-4) used for grouping items in Shopping campaigns.	dimension
description	description	The detailed description of the product.	dimension
destinationStatuses.{NUM}.approvedCountries.{NUM}	destinationStatuses.{NUM}.approvedCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is approved for a specific destination.	dimension
destinationStatuses.{NUM}.channel	destinationStatuses.{NUM}.channel	The channel of the destination, e.g., ‘online’ or ‘local’.	dimension
destinationStatuses.{NUM}.destination	destinationStatuses.{NUM}.destination	The name of the destination where the product is (or will be) listed, e.g., ‘Shopping ads’.	dimension
destinationStatuses.{NUM}.disapprovedCountries.{NUM}	destinationStatuses.{NUM}.disapprovedCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is disapproved for a specific destination.	dimension
destinationStatuses.{NUM}.pendingCountries.{NUM}	destinationStatuses.{NUM}.pendingCountries.{NUM}	A list of country codes (ISO 3166-1 alpha-2) where the product offer is pending approval for a specific destination.	dimension
destinationStatuses.{NUM}.status	destinationStatuses.{NUM}.status	(Deprecated) The approval status of the product in the target country for a specific destination.	dimension
disclosureDate	disclosureDate	The date and time when an offer becomes visible in search results across Google’s YouTube surfaces.	dimension
displayAdsId	displayAdsId	An identifier used for the item in dynamic remarketing campaigns.	dimension
displayAdsLink	displayAdsLink	The URL for the product’s landing page specifically for dynamic remarketing campaigns.	dimension
displayAdsTitle	displayAdsTitle	The title of the item used for dynamic remarketing campaigns.	dimension
displayAdsValue	displayAdsValue	The offer margin for dynamic remarketing campaigns.	metric
energyEfficiencyClass	energyEfficiencyClass	The energy efficiency class of the product, as defined by the EU directive 2010/30/EU.	dimension
excludedDestinations.{NUM}	excludedDestinations.{NUM}	A list of destinations where the product should not be shown.	dimension
expirationDate	expirationDate	The date when the product listing will expire in Google Shopping, formatted in ISO 8601.	dimension
feedLabel	feedLabel	The label associated with the product’s feed.	dimension
freeShippingThreshold.{NUM}.country	freeShippingThreshold.{NUM}.country	The country where the free shipping threshold applies, submitted as an ISO 3166-1 country code.	dimension
freeShippingThreshold.{NUM}.priceThreshold.currency	freeShippingThreshold.{NUM}.priceThreshold.currency	The currency of the price threshold for free shipping, in ISO 4217 format.	dimension
freeShippingThreshold.{NUM}.priceThreshold.value	freeShippingThreshold.{NUM}.priceThreshold.value	The minimum order price above which delivery is free.	metric
gender	gender	The target gender for the item, e.g., ‘male’, ‘female’, ‘unisex’.	dimension
googleExpirationDate	googleExpirationDate	The date when the product listing will expire in Google Shopping, in ISO 8601 format.	dimension
googleProductCategory	googleProductCategory	Google’s category for the item, based on the Google product taxonomy.	dimension
gtin	gtin	The Global Trade Item Number (GTIN) for the product (e.g., UPC, EAN, ISBN).	dimension
id	id	The REST ID of the product. This is a unique identifier for the product.	dimension
identifierExists	identifierExists	Indicates whether a global trade item number (GTIN), manufacturer part number (MPN), or brand exists for the item.	dimension
imageLink	imageLink	The URL of the main image for the product.	dimension
includedDestinations.{NUM}	includedDestinations.{NUM}	Allows your product to participate in specified Google Shopping destinations, such as ‘Shopping_ads’ or ‘Free_listings’.	dimension
installment.amount.currency	installment.amount.currency	The currency of the installment amount, in ISO 4217 format.	dimension
installment.amount.value	installment.amount.value	The numerical amount of each installment payment.	metric
installment.months	installment.months	The number of months over which the installment payments are made.	metric
isBundle	isBundle	Indicates whether the item is a merchant-defined bundle, which is a custom grouping of different products sold by a merchant for a single price.	dimension
itemGroupId	itemGroupId	A shared identifier for a group of product variants, like different sizes or colors of the same product.	metric
itemLevelIssues.{NUM}.applicableCountries.{NUM}	itemLevelIssues.{NUM}.applicableCountries.{NUM}	The countries where a specific item-level issue applies to the product.	dimension
itemLevelIssues.{NUM}.attributeName	itemLevelIssues.{NUM}.attributeName	The name of the attribute affected by an item-level issue.	dimension
itemLevelIssues.{NUM}.code	itemLevelIssues.{NUM}.code	The error code for a specific item-level issue.	dimension
itemLevelIssues.{NUM}.description	itemLevelIssues.{NUM}.description	A description of the item-level issue.	dimension
itemLevelIssues.{NUM}.destination	itemLevelIssues.{NUM}.destination	The destination where the item-level issue applies.	dimension
itemLevelIssues.{NUM}.detail	itemLevelIssues.{NUM}.detail	Additional details about the item-level issue.	dimension
itemLevelIssues.{NUM}.documentation	itemLevelIssues.{NUM}.documentation	A link to documentation or help related to the item-level issue.	dimension
itemLevelIssues.{NUM}.resolution	itemLevelIssues.{NUM}.resolution	Information on how to resolve the item-level issue.	dimension
itemLevelIssues.{NUM}.servability	itemLevelIssues.{NUM}.servability	The servability status of the item due to the issue.	dimension
kind	kind	Identifies the type of resource. For a product status, its value is content#productStatus. For a product, its value is content#product.	dimension
lastUpdateDate	lastUpdateDate	The date and time when the product information was last updated, in ISO 8601 format.	dimension
lifestyleImageLinks.{NUM}	lifestyleImageLinks.{NUM}	Additional URLs of lifestyle images that showcase your item in a real-world context.	dimension
link	link	The URL that links directly to the product’s page on the merchant’s website.	dimension
linkTemplate	linkTemplate	A template for the URL that directly links to the product’s landing page on the merchant’s website.	dimension
material	material	The material(s) from which the product is made.	dimension
maxEnergyEfficiencyClass	maxEnergyEfficiencyClass	The maximum (most efficient) energy efficiency class on the energy consumption scale for the product category.	dimension
maxHandlingTime	maxHandlingTime	The maximal product handling time in business days.	metric
merchant_id	merchant_id	The ID of the Merchant Center account from which the product data was retrieved.	dimension
merchant_name	merchant_name	The name of the Merchant Center account from which the product data was retrieved.	dimension
minEnergyEfficiencyClass	minEnergyEfficiencyClass	The minimum (least efficient) energy efficiency class on the energy consumption scale for the product category.	dimension
minHandlingTime	minHandlingTime	The minimal product handling time in business days.	metric
mobileLink	mobileLink	The URL for the mobile-optimized landing page of the product.	dimension
mobileLinkTemplate	mobileLinkTemplate	A template for the URL that directly links to the product’s mobile-optimized landing page on the merchant’s website.	dimension
mpn	mpn	The Manufacturer Part Number (MPN) of the product.	dimension
multipack	multipack	The number of identical products in a merchant-defined multipack.	metric
offerId	offerId	The unique merchant-defined identifier for the product offer.	dimension
pattern	pattern	The item’s pattern, for example, ‘polka dots’.	dimension
pause	pause	Allows you to temporarily stop showing your product for a short time in Shopping Ads and/or free listings. Supported values are ‘ads’ or ‘all’.	dimension
pickupMethod	pickupMethod	The pickup option available for the item. Acceptable values include “buy”, “reserve”, “ship to store”, or “not supported”.	dimension
pickupSla	pickupSla	The timeline for item store pickup. Acceptable values include “same day”, “next day”, “2-day”, “3-day”, “4-day”, “5-day”, “6-day”, “7-day”, or “multi-week”.	dimension
price.currency	price.currency	The currency of the product’s price, in ISO 4217 format.	dimension
price.value	price.value	The numerical value of the product’s price.	metric
productDetails.{NUM}.attributeName	productDetails.{NUM}.attributeName	The name of a specific product attribute, such as ‘color’ or ‘material’.	dimension
productDetails.{NUM}.attributeValue	productDetails.{NUM}.attributeValue	The value associated with a specific product attribute, such as ‘red’ for ‘color’.	dimension
productDetails.{NUM}.sectionName	productDetails.{NUM}.sectionName	The name of the section for additional product details, providing a structured way to describe product specifications.	dimension
productHeight.unit	productHeight.unit	The unit of measurement for the product’s height (e.g., ‘cm’, ‘in’).	dimension
productHeight.value	productHeight.value	The numerical value of the product’s height.	metric
productHighlights.{NUM}	productHighlights.{NUM}	Short bulleted lists of the most relevant highlights of a product, providing quick-to-scan information for shoppers.	dimension
productId	productId	The REST ID of the product for which status is reported.	dimension
productLength.unit	productLength.unit	The unit of measurement for the product’s length (e.g., ‘cm’, ‘in’).	dimension
productLength.value	productLength.value	The numerical value of the product’s length.	metric
productTypes.{NUM}	productTypes.{NUM}	The merchant-specific product type or category.	dimension
productWeight.unit	productWeight.unit	The unit of measurement for the product’s weight (e.g., ‘kg’, ‘lb’).	dimension
productWeight.value	productWeight.value	The numerical value of the product’s weight.	metric
productWidth.unit	productWidth.unit	The unit of measurement for the product’s width (e.g., ‘cm’, ‘in’).	dimension
productWidth.value	productWidth.value	The numerical value of the product’s width.	metric
promotionIds.{NUM}	promotionIds.{NUM}	The unique identifier for an active promotion associated with the product.	dimension
salePrice.currency	salePrice.currency	The currency of the product’s sale price, in ISO 4217 format.	dimension
salePrice.value	salePrice.value	The numerical value of the product’s sale price.	metric
salePriceEffectiveDate	salePriceEffectiveDate	The date range during which the sale price is effective.	dimension
sellOnGoogleQuantity	sellOnGoogleQuantity	The quantity of the product that is available for selling on Google.	metric
shipping.{NUM}.country	shipping.{NUM}.country	The country code (ISO 3166-1 alpha-2) for a specific shipping service.	dimension
shipping.{NUM}.maxHandlingTime	shipping.{NUM}.maxHandlingTime	The maximum number of business days required to handle the product before shipping.	metric
shipping.{NUM}.maxTransitTime	shipping.{NUM}.maxTransitTime	The maximum number of business days for the product to be in transit.	metric
shipping.{NUM}.minHandlingTime	shipping.{NUM}.minHandlingTime	The minimum number of business days required to handle the product before shipping.	metric
shipping.{NUM}.minTransitTime	shipping.{NUM}.minTransitTime	The minimum number of business days for the product to be in transit.	metric
shipping.{NUM}.price.currency	shipping.{NUM}.price.currency	The currency of the shipping price, in ISO 4217 format.	dimension
shipping.{NUM}.price.value	shipping.{NUM}.price.value	The numerical value of the shipping price.	metric
shipping.{NUM}.service	shipping.{NUM}.service	The shipping service used for the product (e.g., “Standard Shipping”, “Expedited”).	dimension
shippingLabel	shippingLabel	A label used to group products for account-level shipping rules.	dimension
shippingWeight.unit	shippingWeight.unit	The unit of weight for the product’s shipping weight, such as ‘kg’ or ‘lb’.	dimension
shippingWeight.value	shippingWeight.value	The numerical value of the product’s shipping weight.	metric
sizeSystem	sizeSystem	The system in which the size is specified (e.g., US, EU).	dimension
sizeType	sizeType	The cut or type of the item’s size (e.g., ‘regular’, ‘petite’).	dimension
sizes.{NUM}	sizes.{NUM}	The size of the item.	dimension
source	source	Indicates how the product offer was created, such as via ‘api’, ‘crawl’, or ‘feed’.	dimension
structuredDescription.content	structuredDescription.content	The actual content of the structured product description, which can be AI-generated.	dimension
structuredDescription.digitalSourceType	structuredDescription.digitalSourceType	Specifies the digital source type for the product description, indicating whether the content was created using generative AI (trained_algorithmic_media) or is a default (not AI-generated) description (default).	dimension
subscriptionCost.amount.currency	subscriptionCost.amount.currency	The currency of the subscription cost, in ISO 4217 format.	dimension
subscriptionCost.amount.value	subscriptionCost.amount.value	The numerical amount of the subscription payment per period.	metric
subscriptionCost.period	subscriptionCost.period	The duration of a single subscription period, such as ‘month’ or ‘year’.	dimension
subscriptionCost.periodLength	subscriptionCost.periodLength	The number of subscription periods (months or years) that the buyer must pay.	metric
targetCountry	targetCountry	The target country for which the product information is provided.	dimension
taxes.{NUM}.rate	taxes.{NUM}.rate	The tax rate applicable to the product.	metric
title	title	The title of the product.	dimension
transitTimeLabel	transitTimeLabel	A label used to group products in account-level transit time tables.	dimension
unitPricingBaseMeasure.unit	unitPricingBaseMeasure.unit	The unit of the base measure for unit pricing (e.g., ‘g’, ‘ml’).	dimension
unitPricingBaseMeasure.value	unitPricingBaseMeasure.value	The value of the base measure for unit pricing (e.g., 100 for 100g).	metric
unitPricingMeasure.unit	unitPricingMeasure.unit	The unit of the measure for the item’s unit pricing (e.g., ‘g’, ‘ml’, ‘sheet’).	dimension
unitPricingMeasure.value	unitPricingMeasure.value	The value of the measure for the item’s unit pricing.	metric