Products

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

Resource representations

JSON

{
  "kind": "content#product",
  "id": string,
  "offerId": 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,
  "unitPricingMeasure": {
    "value": double,
    "unit": string
  },
  "unitPricingBaseMeasure": {
    "value": long,
    "unit": string
  },
  "multipack": long,
  "adwordsGrouping": string,
  "adwordsLabels": [
    string
  ],
  "adwordsRedirect": 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
additionalProductTypes[] list Additional categories of the item (formatted as in products feed 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
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
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", "type": "text", "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 or FLOAT. 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 or FLOAT. 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
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.
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
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".
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
maxHandlingTime long Maximal product handling time (in business days). writable
minHandlingTime long Minimal product handling time (in business days). 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 An identifier of 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. 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 feed 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 feed specification). writable
sellOnGoogleQuantity long The quantity of the product that is reserved for sell-on-google ads. writable
shippingHeight nested object Height of the item for shipping. writable
shippingHeight.unit string The unit of value.

Acceptable values are:
  • "cm"
  • "in"
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.

Acceptable values are:
  • "cm"
  • "in"
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.

Acceptable values are:
  • "cm"
  • "in"
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
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 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>
  <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>
  <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.
product/additional_product_type string Additional categories of the item (formatted as in products feed 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/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", "type": "text", "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 or FLOAT. 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 or FLOAT. 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_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.
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/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/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_handling_time long Maximal product handling time (in business days). writable
product/min_handling_time long Minimal product handling time (in business days). 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 An identifier of 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. 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 feed 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 feed specification). writable
product/sell_on_google_quantity long The quantity of the product that is reserved for sell-on-google ads. 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.

Acceptable values are:
  • "cm"
  • "in"
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.

Acceptable values are:
  • "cm"
  • "in"
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.

Acceptable values are:
  • "cm"
  • "in"
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 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. This method can only be called for non-multi-client accounts.
delete
Deletes a product from your Merchant Center account. This method can only be called for non-multi-client accounts.
get
Retrieves a product from your Merchant Center account. This method can only be called for non-multi-client accounts.
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. This method can only be called for non-multi-client accounts.
list
Lists the products in your Merchant Center account. This method can only be called for non-multi-client accounts.

Send feedback about...

Content API for Shopping