If you're still using v2 of the Content API for Shopping, please migrate to v2.1 immediately to avoid disruptions with your integration.

For more information, see Migrating to v2.1 and this blog post.

v2 to v2.1 changes

There are a number of changes to the Product API get, delete, list, insert methods, and the Product Resource from v2 to v2.1. For more information on updating your application for v2.1, see Migrating from Content API v2 to v2.1.

Supplemental Feeds API

The Supplemental Feeds API is a new functionality available only in the v2.1 API that allows you to update and delete data associated with specific feeds.


POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

The v2.1 product.insert works like the v2 product.insert unless you provide a valid supplemental content API feedId (a numeric value), which causes the data associated with the duplicated item IDs to update the existing items.

You must include the offerId, targetCountry, channel, and contentLanguage. All other attributes are optional.

Use this call to change values for an existing item, such as price or availability, just as in a supplemental feed.

To create a supplemental Content API feed, first, create a supplemental feed and select the Content API as the feed type. On the next screen, select the feed that you would like to supplement. The supplemental feed provides the feedId after it creates the feed.


DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

Calling this method removes the supplemental data provided by the specified supplemental Content API feed.

Multi-client accounts

It is possible to create supplemental feeds for multi-client accounts. Once created, supplemental data can be inserted to all sub-accounts with the same feedId.