Products

Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information.

Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page.

For a list of methods for this resource, see the end of this page.

Resource representations

Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.

JSON

{
  "kind": "content#product",
  "id": string,
  "offerId": string,
  "source": string,
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "imageLink": string,
  "additionalImageLinks": [
    string
  ],
  "contentLanguage": string,
  "targetCountry": string,
  "channel": string,
  "expirationDate": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "availabilityDate": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "price": {
    "value": string,
    "currency": string
  },
  "installment": {
    "months": long,
    "amount": {
      "value": string,
      "currency": string
    }
  },
  "loyaltyPoints": {
    "name": string,
    "pointsValue": long,
    "ratio": double
  },
  "productType": string,
  "additionalProductTypes": [
    string
  ],
  "salePrice": {
    "value": string,
    "currency": string
  },
  "salePriceEffectiveDate": string,
  "sellOnGoogleQuantity": long,
  "shipping": [
    {
      "price": {
        "value": string,
        "currency": string
      },
      "country": string,
      "region": string,
      "service": string,
      "locationId": long,
      "locationGroupName": string,
      "postalCode": string
    }
  ],
  "shippingWeight": {
    "value": double,
    "unit": string
  },
  "shippingLength": {
    "value": double,
    "unit": string
  },
  "shippingWidth": {
    "value": double,
    "unit": string
  },
  "shippingHeight": {
    "value": double,
    "unit": string
  },
  "maxHandlingTime": long,
  "minHandlingTime": long,
  "shippingLabel": string,
  "sizes": [
    string
  ],
  "sizeSystem": string,
  "sizeType": string,
  "taxes": [
    {
      "rate": double,
      "country": string,
      "region": string,
      "taxShip": boolean,
      "locationId": long,
      "postalCode": string
    }
  ],
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "unitPricingMeasure": {
    "value": double,
    "unit": string
  },
  "unitPricingBaseMeasure": {
    "value": long,
    "unit": string
  },
  "multipack": long,
  "adwordsGrouping": string,
  "adwordsLabels": [
    string
  ],
  "adwordsRedirect": string,
  "costOfGoodsSold": {
    "value": string,
    "currency": string
  },
  "displayAdsId": string,
  "displayAdsSimilarIds": [
    string
  ],
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": double,
  "promotionIds": [
    string
  ],
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "destinations": [
    {
      "destinationName": string,
      "intention": string
    }
  ],
  "aspects": [
    {
      "aspectName": string,
      "destinationName": string,
      "intention": string
    }
  ],
  "onlineOnly": boolean,
  "validatedDestinations": [
    string
  ],
  "customAttributes": [
    {
      "name": string,
      "type": string,
      "unit": string,
      "value": string
    }
  ],
  "customGroups": [
    {
      "name": string,
      "attributes": [
        {
          "name": string,
          "type": string,
          "unit": string,
          "value": string
        }
      ]
    }
  ],
  "warnings": [
    {
      "domain": string,
      "reason": string,
      "message": string
    }
  ]
}

Property name	Value	Description	Notes
additionalImageLinks[]	list	Additional URLs of images of the item.	writable
additionalProductTypes[]	list	Additional categories of the item (formatted as in products data specification).	writable
adult	boolean	Set to true if the item is targeted towards adults.	writable
adwordsGrouping	string	Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise.	writable
adwordsLabels[]	list	Similar to adwords_grouping, but only works on CPC.	writable
adwordsRedirect	string	Allows advertisers to override the item URL when the product is shown within the context of Product Ads.	writable
ageGroup	string	Target age group of the item. Acceptable values are: "adult" "infant" "kids" "newborn" "toddler"	writable
aspects[]	list	Deprecated. Do not use.
availability	string	Availability status of the item. Acceptable values are: "in stock" "out of stock" "preorder"	writable
availabilityDate	string	The day a pre-ordered product becomes available for delivery, in ISO 8601 format.	writable
brand	string	Brand of the item.	writable
channel	string	The item's channel (online or local). Acceptable values are: "local" "online"	writable
color	string	Color of the item.	writable
condition	string	Condition or state of the item. Acceptable values are: "new" "refurbished" "used"	writable
contentLanguage	string	The two-letter ISO 639-1 language code for the item.	writable
costOfGoodsSold	nested object	Cost of goods sold. Used for gross profit reporting.	writable
costOfGoodsSold.currency	string	The currency of the price.	writable
costOfGoodsSold.value	string	The price represented as a number.	writable
customAttributes[]	list	A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (e.g., { "name": "size type", "value": "regular" }). This is useful for submitting attributes not explicitly exposed by the API.	writable
customAttributes[].name	string	The name of the attribute. Underscores will be replaced by spaces upon insertion.	writable
customAttributes[].type	string	The type of the attribute. Acceptable values are: "boolean" "datetimerange" "float" "group" "int" "price" "text" "time" "url"	writable
customAttributes[].unit	string	Free-form unit of the attribute. Unit can only be used for values of type int, float, or price.	writable
customAttributes[].value	string	The value of the attribute.	writable
customGroups[]	list	A list of custom (merchant-provided) custom attribute groups.	writable
customGroups[].attributes[]	list	The sub-attributes.	writable
customGroups[].attributes[].name	string	The name of the attribute. Underscores will be replaced by spaces upon insertion.	writable
customGroups[].attributes[].type	string	The type of the attribute. Acceptable values are: "boolean" "datetimerange" "float" "group" "int" "price" "text" "time" "url"	writable
customGroups[].attributes[].unit	string	Free-form unit of the attribute. Unit can only be used for values of type int, float, or price.	writable
customGroups[].attributes[].value	string	The value of the attribute.	writable
customGroups[].name	string	The name of the group. Underscores will be replaced by spaces upon insertion.	writable
customLabel0	string	Custom label 0 for custom grouping of items in a Shopping campaign.	writable
customLabel1	string	Custom label 1 for custom grouping of items in a Shopping campaign.	writable
customLabel2	string	Custom label 2 for custom grouping of items in a Shopping campaign.	writable
customLabel3	string	Custom label 3 for custom grouping of items in a Shopping campaign.	writable
customLabel4	string	Custom label 4 for custom grouping of items in a Shopping campaign.	writable
description	string	Description of the item.	writable
destinations[]	list	Specifies the intended destinations for the product.	writable
destinations[].destinationName	string	The name of the destination.	writable
destinations[].intention	string	Whether the destination is required, excluded or should be validated. Acceptable values are: "default" "excluded" "optional" "required"	writable
displayAdsId	string	An identifier for an item for dynamic remarketing campaigns.	writable
displayAdsLink	string	URL directly to your item's landing page for dynamic remarketing campaigns.	writable
displayAdsSimilarIds[]	list	Advertiser-specified recommendations.	writable
displayAdsTitle	string	Title of an item for dynamic remarketing campaigns.	writable
displayAdsValue	double	Offer margin for dynamic remarketing campaigns.	writable
energyEfficiencyClass	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
expirationDate	string	Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future.	writable
gender	string	Target gender of the item. Acceptable values are: "female" "male" "unisex"	writable
googleProductCategory	string	Google's category of the item (see Google product taxonomy).	writable
gtin	string	Global Trade Item Number (GTIN) of the item.	writable
id	string	The REST ID of the product. Content API methods that operate on products take this as their productId parameter. The REST ID for a product is of the form channel:contentLanguage:targetCountry:offerId.
identifierExists	boolean	False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.	writable
imageLink	string	URL of an image of the item.	writable
installment	nested object	Number and amount of installments to pay for an item. Brazil only.	writable
installment.amount	nested object	The amount the buyer has to pay per month.	writable
installment.amount.currency	string	The currency of the price.	writable
installment.amount.value	string	The price represented as a number.	writable
installment.months	long	The number of installments the buyer has to pay.	writable
isBundle	boolean	Whether the item is a merchant-defined bundle. A bundle is a custom grouping of different products sold by a merchant for a single price.	writable
itemGroupId	string	Shared identifier for all variants of the same product.	writable
kind	string	Identifies what kind of resource this is. Value: the fixed string "content#product".
link	string	URL directly linking to your item's page on your website.	writable
loyaltyPoints	nested object	Loyalty points that users receive after purchasing the item. Japan only.	writable
loyaltyPoints.name	string	Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.	writable
loyaltyPoints.pointsValue	long	The retailer's loyalty points in absolute value.	writable
loyaltyPoints.ratio	double	The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.	writable
material	string	The material of which the item is made.	writable
maxEnergyEfficiencyClass	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
maxHandlingTime	long	Maximal product handling time (in business days).	writable
minEnergyEfficiencyClass	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
minHandlingTime	long	Minimal product handling time (in business days).	writable
mobileLink	string	Link to a mobile-optimized version of the landing page.	writable
mpn	string	Manufacturer Part Number (MPN) of the item.	writable
multipack	long	The number of identical products in a merchant-defined multipack.	writable
offerId	string	A unique identifier for the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. See the products feed specification for details. Note: Content API methods that operate on products take the REST ID of the product, not this identifier.	writable
pattern	string	The item's pattern (e.g. polka dots).	writable
price	nested object	Price of the item.	writable
price.currency	string	The currency of the price.	writable
price.value	string	The price represented as a number.	writable
productType	string	Your category of the item (formatted as in products data specification).	writable
promotionIds[]	list	The unique ID of a promotion.	writable
salePrice	nested object	Advertised sale price of the item.	writable
salePrice.currency	string	The currency of the price.	writable
salePrice.value	string	The price represented as a number.	writable
salePriceEffectiveDate	string	Date range during which the item is on sale (see products data specification).	writable
sellOnGoogleQuantity	long	The quantity of the product that is available for selling on Google. Supported only for online products.	writable
shippingHeight	nested object	Height of the item for shipping.	writable
shippingHeight.unit	string	The unit of value.	writable
shippingHeight.value	double	The dimension of the product used to calculate the shipping cost of the item.	writable
shippingLabel	string	The shipping label of the product, used to group product in account-level shipping rules.	writable
shippingLength	nested object	Length of the item for shipping.	writable
shippingLength.unit	string	The unit of value.	writable
shippingLength.value	double	The dimension of the product used to calculate the shipping cost of the item.	writable
shippingWeight	nested object	Weight of the item for shipping.	writable
shippingWeight.unit	string	The unit of value.	writable
shippingWeight.value	double	The weight of the product used to calculate the shipping cost of the item.	writable
shippingWidth	nested object	Width of the item for shipping.	writable
shippingWidth.unit	string	The unit of value.	writable
shippingWidth.value	double	The dimension of the product used to calculate the shipping cost of the item.	writable
shipping[]	list	Shipping rules.	writable
shipping[].country	string	The CLDR territory code of the country to which an item will ship.	writable
shipping[].locationGroupName	string	The location where the shipping is applicable, represented by a location group name.	writable
shipping[].locationId	long	The numeric ID of a location that the shipping rate applies to as defined in the AdWords API.	writable
shipping[].postalCode	string	The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.	writable
shipping[].price	nested object	Fixed shipping price, represented as a number.	writable
shipping[].price.currency	string	The currency of the price.	writable
shipping[].price.value	string	The price represented as a number.	writable
shipping[].region	string	The geographic region to which a shipping rate applies.	writable
shipping[].service	string	A free-form description of the service class or delivery speed.	writable
sizeSystem	string	System in which the size is specified. Recommended for apparel items. Acceptable values are: "AU" "BR" "CN" "DE" "EU" "FR" "IT" "JP" "MEX" "UK" "US"	writable
sizeType	string	The cut of the item. Recommended for apparel items. Acceptable values are: "big and tall" "maternity" "oversize" "petite" "plus" "regular"	writable
sizes[]	list	Size of the item.	writable
source	string	The source of the offer, i.e., how the offer was created. Acceptable values are: "api" "crawl" "feed"
targetCountry	string	The CLDR territory code for the item.	writable
taxes[]	list	Tax information.	writable
taxes[].country	string	The country within which the item is taxed, specified as a CLDR territory code.	writable
taxes[].locationId	long	The numeric ID of a location that the tax rate applies to as defined in the AdWords API.	writable
taxes[].postalCode	string	The postal code range that the tax rate applies to, represented by a ZIP code, a ZIP code prefix using * wildcard, a range between two ZIP codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460, 94*-95*.	writable
taxes[].rate	double	The percentage of tax rate that applies to the item price.	writable
taxes[].region	string	The geographic region to which the tax rate applies.	writable
taxes[].taxShip	boolean	Set to true if tax is charged on shipping.	writable
title	string	Title of the item.	writable
unitPricingBaseMeasure	nested object	The preference of the denominator of the unit price.	writable
unitPricingBaseMeasure.unit	string	The unit of the denominator.	writable
unitPricingBaseMeasure.value	long	The denominator of the unit price.	writable
unitPricingMeasure	nested object	The measure and dimension of an item.	writable
unitPricingMeasure.unit	string	The unit of the measure.	writable
unitPricingMeasure.value	double	The measure of an item.	writable
validatedDestinations[]	list	Deprecated. The read-only list of intended destinations which passed validation.
warnings[]	list	Read-only warnings.
warnings[].domain	string	The domain of the error.
warnings[].message	string	A description of the error.
warnings[].reason	string	The error code.

XML

<product>
  <id>
    string
  </id>
  <offer_id>
    string
  </offer_id>
  <identifier_exists>
    boolean
  </identifier_exists>
  <is_bundle>
    boolean
  </is_bundle>
  <title>
    string
  </title>
  <description>
    string
  </description>
  <link>
    string
  </link>
  <mobile_link>
    string
  </mobile_link>
  <image_link>
    string
  </image_link>
  (foreach)
    <additional_image_link>
      string
    </additional_image_link>
  (/foreach)
  (foreach)
    <additional_product_type>
      string
    </additional_product_type>
  (/foreach)
  <content_language>
    string
  </content_language>
  <target_country>
    string
  </target_country>
  <channel>
    string
  </channel>
  <expiration_date>
    string
  </expiration_date>
  <adult>
    boolean
  </adult>
  <age_group>
    string
  </age_group>
  <availability>
    string
  </availability>
  <availability_date>
    string
  </availability_date>
  <brand>
    string
  </brand>
  <color>
    string
  </color>
  <condition>
    string
  </condition>
  <gender>
    string
  </gender>
  <google_product_category>
    string
  </google_product_category>
  <gtin>
    string
  </gtin>
  <item_group_id>
    string
  </item_group_id>
  <material>
    string
  </material>
  <mpn>
    string
  </mpn>
  <pattern>
    string
  </pattern>
  <price currency="string">
    string
  </price>
  <installment>
    <months>
      long
    </months>
    <amount currency="string">
      string
    </amount>
  </installment>
  <loyalty_points>
    <name>
      string
    </name>
    <points_value>
      long
    </points_value>
    <ratio>
      double
    </ratio>
  </loyalty_points>
  <product_type>
    string
  </product_type>
  (foreach)
    <promotion_id>
      string
    </promotion_id>
  (/foreach)
  <sale_price currency="string">
    string
  </sale_price>
  <sale_price_effective_date>
    string
  </sale_price_effective_date>
  <sell_on_google_quantity>
    long
  </sell_on_google_quantity>
  (foreach)
    <shipping>
      <price currency="string">
        string
      </price>
      <country>
        string
      </country>
      <region>
        string
      </region>
      <service>
        string
      </service>
      <location_id>
        long
      </location_id>
      <location_group_name>
        string
      </location_group_name>
      <postal_code>
        string
      </postal_code>
    </shipping>
  (/foreach)
  <shipping_weight unit="string">
    double
  </shipping_weight>
  <shipping_length unit="string">
    double
  </shipping_length>
  <shipping_width unit="string">
    double
  </shipping_width>
  <shipping_height unit="string">
    double
  </shipping_height>
  <shipping_label>
    string
  </shipping_label>
  <max_handling_time>
    long
  </max_handling_time>
  <min_handling_time>
    long
  </min_handling_time>
  (foreach)
    <size>
      string
    </size>
  (/foreach)
  <size_system>
    string
  </size_system>
  <size_type>
    string
  </size_type>
  (foreach)
    <tax>
      <rate>
        double
      </rate>
      <country>
        string
      </country>
      <region>
        string
      </region>
      <ship>
        boolean
      </ship>
      <location_id>
        long
      </location_id>
      <postal_code>
        string
      </postal_code>
    </tax>
  (/foreach)
  <energy_efficiency_class>
    string
  </energy_efficiency_class>
  <min_energy_efficiency_class>
    string
  </min_energy_efficiency_class>
  <max_energy_efficiency_class>
    string
  </max_energy_efficiency_class>
  <unit_pricing_measure unit="string">
    double
  </unit_pricing_measure>
  <unit_pricing_base_measure unit="string">
    long
  </unit_pricing_base_measure>
  <multipack>
    long
  </multipack>
  <adwords_grouping>
    string
  </adwords_grouping>
  (foreach)
    <adwords_label>
      string
    </adwords_label>
  (/foreach)
  <adwords_redirect>
    string
  </adwords_redirect>
  <cost_of_goods_sold currency="string">
    string
  </cost_of_goods_sold>
  <display_ads_id>
    string
  </display_ads_id>
  (foreach)
    <display_ads_similar_id>
      string
    </display_ads_similar_id>
  (/foreach)
  <display_ads_title>
    string
  </display_ads_title>
  <display_ads_link>
    string
  </display_ads_link>
  <display_ads_value>
    double
  </display_ads_value>
  (foreach)
    <destination intention="string">
      string
    </destination>
  (/foreach)
  (foreach)
    <aspect intention="string" destination_name="string">
      string
    </aspect>
  (/foreach)
  <custom_label_0>
    string
  </custom_label_0>
  <custom_label_1>
    string
  </custom_label_1>
  <custom_label_2>
    string
  </custom_label_2>
  <custom_label_3>
    string
  </custom_label_3>
  <custom_label_4>
    string
  </custom_label_4>
  <online_only>
    boolean
  </online_only>
  (foreach)
    <validated_destination>
      string
    </validated_destination>
  (/foreach)
  (foreach)
    <custom_attribute name="string" type="string" unit="string">
      string
    </custom_attribute>
  (/foreach)
  (foreach)
    <custom_group name="string">
      (foreach)
        <custom_attribute name="string" type="string" unit="string">
          string
        </custom_attribute>
      (/foreach)
    </custom_group>
  (/foreach)
  (foreach)
    <warning>
      <domain>
        GData
        string
      </domain>
      <code>
        string
      </code>
      <internalReason>
        string
      </internalReason>
    </warning>
  (/foreach)
</product>

Property name	Value	Description	Notes
product	object	Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.
product/additional_image_link	string	Additional URLs of images of the item.	writable
product/additional_product_type	string	Additional categories of the item (formatted as in products data specification).	writable
product/adult	boolean	Set to true if the item is targeted towards adults.	writable
product/adwords_grouping	string	Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise.	writable
product/adwords_label	string	Similar to adwords_grouping, but only works on CPC.	writable
product/adwords_redirect	string	Allows advertisers to override the item URL when the product is shown within the context of Product Ads.	writable
product/age_group	string	Target age group of the item. Acceptable values are: "adult" "infant" "kids" "newborn" "toddler"	writable
product/availability	string	Availability status of the item. Acceptable values are: "in stock" "out of stock" "preorder"	writable
product/availability_date	string	The day a pre-ordered product becomes available for delivery, in ISO 8601 format.	writable
product/brand	string	Brand of the item.	writable
product/channel	string	The item's channel (online or local). Acceptable values are: "local" "online"	writable
product/color	string	Color of the item.	writable
product/condition	string	Condition or state of the item. Acceptable values are: "new" "refurbished" "used"	writable
product/content_language	string	The two-letter ISO 639-1 language code for the item.	writable
product/cost_of_goods_sold	string	The price represented as a number.	writable
product/cost_of_goods_sold/currency	string	The currency of the price.	writable
product/custom_attribute	string	A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (e.g., { "name": "size type", "value": "regular" }). This is useful for submitting attributes not explicitly exposed by the API.	writable
product/custom_attribute/name	string	The name of the attribute. Underscores will be replaced by spaces upon insertion.	writable
product/custom_attribute/type	string	The type of the attribute. Acceptable values are: "boolean" "datetimerange" "float" "group" "int" "price" "text" "time" "url"	writable
product/custom_attribute/unit	string	Free-form unit of the attribute. Unit can only be used for values of type int, float, or price.	writable
product/custom_group	object	A list of custom (merchant-provided) custom attribute groups.	writable
product/custom_group/custom_attribute	string	The sub-attributes.	writable
product/custom_group/custom_attribute/name	string	The name of the attribute. Underscores will be replaced by spaces upon insertion.	writable
product/custom_group/custom_attribute/type	string	The type of the attribute. Acceptable values are: "boolean" "datetimerange" "float" "group" "int" "price" "text" "time" "url"	writable
product/custom_group/custom_attribute/unit	string	Free-form unit of the attribute. Unit can only be used for values of type int, float, or price.	writable
product/custom_group/name	string	The name of the group. Underscores will be replaced by spaces upon insertion.	writable
product/custom_label_0	string	Custom label 0 for custom grouping of items in a Shopping campaign.	writable
product/custom_label_1	string	Custom label 1 for custom grouping of items in a Shopping campaign.	writable
product/custom_label_2	string	Custom label 2 for custom grouping of items in a Shopping campaign.	writable
product/custom_label_3	string	Custom label 3 for custom grouping of items in a Shopping campaign.	writable
product/custom_label_4	string	Custom label 4 for custom grouping of items in a Shopping campaign.	writable
product/description	string	Description of the item.	writable
product/destination	string	The name of the destination.	writable
product/destination/intention	string	Whether the destination is required, excluded or should be validated. Acceptable values are: "default" "excluded" "optional" "required"	writable
product/display_ads_id	string	An identifier for an item for dynamic remarketing campaigns.	writable
product/display_ads_link	string	URL directly to your item's landing page for dynamic remarketing campaigns.	writable
product/display_ads_similar_id	string	Advertiser-specified recommendations.	writable
product/display_ads_title	string	Title of an item for dynamic remarketing campaigns.	writable
product/display_ads_value	double	Offer margin for dynamic remarketing campaigns.	writable
product/energy_efficiency_class	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
product/expiration_date	string	Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future.	writable
product/gender	string	Target gender of the item. Acceptable values are: "female" "male" "unisex"	writable
product/google_product_category	string	Google's category of the item (see Google product taxonomy).	writable
product/gtin	string	Global Trade Item Number (GTIN) of the item.	writable
product/id	string	The REST ID of the product. Content API methods that operate on products take this as their productId parameter. The REST ID for a product is of the form channel:contentLanguage:targetCountry:offerId.
product/identifier_exists	boolean	False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.	writable
product/image_link	string	URL of an image of the item.	writable
product/installment	object	Number and amount of installments to pay for an item. Brazil only.	writable
product/installment/amount	string	The price represented as a number.	writable
product/installment/amount/currency	string	The currency of the price.	writable
product/installment/months	long	The number of installments the buyer has to pay.	writable
product/is_bundle	boolean	Whether the item is a merchant-defined bundle. A bundle is a custom grouping of different products sold by a merchant for a single price.	writable
product/item_group_id	string	Shared identifier for all variants of the same product.	writable
product/link	string	URL directly linking to your item's page on your website.	writable
product/loyalty_points	object	Loyalty points that users receive after purchasing the item. Japan only.	writable
product/loyalty_points/name	string	Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.	writable
product/loyalty_points/points_value	long	The retailer?s loyalty points in absolute value.	writable
product/loyalty_points/ratio	double	The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.	writable
product/material	string	The material of which the item is made.	writable
product/max_energy_efficiency_class	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
product/max_handling_time	long	Maximal product handling time (in business days).	writable
product/min_energy_efficiency_class	string	The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: "A" "A+" "A++" "A+++" "B" "C" "D" "E" "F" "G"	writable
product/min_handling_time	long	Minimal product handling time (in business days).	writable
product/mobile_link	string	Link to a mobile-optimized version of the landing page.	writable
product/mpn	string	Manufacturer Part Number (MPN) of the item.	writable
product/multipack	long	The number of identical products in a merchant-defined multipack.	writable
product/offer_id	string	A unique identifier for the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. See the products feed specification for details. Note: Content API methods that operate on products take the REST ID of the product, not this identifier.	writable
product/pattern	string	The item's pattern (e.g. polka dots).	writable
product/price	string	The price represented as a number.	writable
product/price/currency	string	The currency of the price.	writable
product/product_type	string	Your category of the item (formatted as in products data specification).	writable
product/promotion_id	string	The unique ID of a promotion.	writable
product/sale_price	string	The price represented as a number.	writable
product/sale_price/currency	string	The currency of the price.	writable
product/sale_price_effective_date	string	Date range during which the item is on sale (see products data specification).	writable
product/sell_on_google_quantity	long	The quantity of the product that is available for selling on Google. Supported only for online products.	writable
product/shipping	object	Shipping rules.	writable
product/shipping/country	string	The CLDR territory code of the country to which an item will ship.	writable
product/shipping/location_group_name	string	The location where the shipping is applicable, represented by a location group name.	writable
product/shipping/location_id	long	The numeric ID of a location that the shipping rate applies to as defined in the AdWords API.	writable
product/shipping/postal_code	string	The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.	writable
product/shipping/price	string	The price represented as a number.	writable
product/shipping/price/currency	string	The currency of the price.	writable
product/shipping/region	string	The geographic region to which a shipping rate applies.	writable
product/shipping/service	string	A free-form description of the service class or delivery speed.	writable
product/shipping_height	double	The dimension of the product used to calculate the shipping cost of the item.	writable
product/shipping_height/unit	string	The unit of value.	writable
product/shipping_label	string	The shipping label of the product, used to group product in account-level shipping rules.	writable
product/shipping_length	double	The dimension of the product used to calculate the shipping cost of the item.	writable
product/shipping_length/unit	string	The unit of value.	writable
product/shipping_weight	double	The weight of the product used to calculate the shipping cost of the item.	writable
product/shipping_weight/unit	string	The unit of value.	writable
product/shipping_width	double	The dimension of the product used to calculate the shipping cost of the item.	writable
product/shipping_width/unit	string	The unit of value.	writable
product/size	string	Size of the item.	writable
product/size_system	string	System in which the size is specified. Recommended for apparel items. Acceptable values are: "AU" "BR" "CN" "DE" "EU" "FR" "IT" "JP" "MEX" "UK" "US"	writable
product/size_type	string	The cut of the item. Recommended for apparel items. Acceptable values are: "big and tall" "maternity" "oversize" "petite" "plus" "regular"	writable
product/target_country	string	The CLDR territory code for the item.	writable
product/tax	object	Tax information.	writable
product/tax/country	string	The country within which the item is taxed, specified as a CLDR territory code.	writable
product/tax/location_id	long	The numeric ID of a location that the tax rate applies to as defined in the AdWords API.	writable
product/tax/postal_code	string	The postal code range that the tax rate applies to, represented by a ZIP code, a ZIP code prefix using * wildcard, a range between two ZIP codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460, 94*-95*.	writable
product/tax/rate	double	The percentage of tax rate that applies to the item price.	writable
product/tax/region	string	The geographic region to which the tax rate applies.	writable
product/tax/ship	boolean	Set to true if tax is charged on shipping.	writable
product/title	string	Title of the item.	writable
product/unit_pricing_base_measure	long	The denominator of the unit price.	writable
product/unit_pricing_base_measure/unit	string	The unit of the denominator.	writable
product/unit_pricing_measure	double	The measure of an item.	writable
product/unit_pricing_measure/unit	string	The unit of the measure.	writable
product/validated_destination	string	Deprecated. The read-only list of intended destinations which passed validation.
product/warning	object	Read-only warnings. An error returned by the API.
product/warning/code	string	The error code.
product/warning/domain	string	The domain of the error.
product/warning/internalReason	string	A description of the error.

Methods

custombatch

Retrieves, inserts, and deletes multiple products in a single request.

delete

Deletes a product from your Merchant Center account.

get

Retrieves a product from your Merchant Center account.

insert

Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry.

list

Lists the products in your Merchant Center account.