We will sunset v2 of the Content API on March 29th, 2021. To avoid disruptions with your integration, please migrate to v2.1 as soon as possible. For more information, see Migrating to v2.1.

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.