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.

Method: products.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.

HTTP request

POST https://shoppingcontent.googleapis.com/content/v2/{merchantId}/products

Path parameters



The ID of the account that contains the product. This account cannot be a multi-client account.

Query parameters



Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).

Request body

The request body contains an instance of Product.

Response body

If successful, the response body contains a newly created instance of Product.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/content

For more information, see the OAuth 2.0 Overview.