Method: products.update

  • This operation updates an existing product in your Merchant Center account, modifying only the attributes specified in the request.

  • You need to use an HTTP PATCH request with the product and merchant IDs in the URL path.

  • A updateMask query parameter lets you control which attributes are updated or deleted, requiring a FieldMask format for listing the target attributes.

  • The request body should contain a Product object with the desired updates, and the successful response will return the updated Product object.

  • Authorization requires the https://www.googleapis.com/auth/content OAuth scope.

Updates an existing product in your Merchant Center account. Only updates attributes provided in the request.

HTTP request

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

Path parameters

Parameters
merchantId

string

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

string

The REST ID of the product for which to update.

Query parameters

Parameters
updateMask

string (FieldMask format)

The comma-separated list of product attributes to be updated. Example: "title,salePrice". Attributes specified in the update mask without a value specified in the body will be deleted from the product. You must specify the update mask to delete attributes. Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged.

Request body

The request body contains an instance of Product.

Response body

If successful, the response body contains an 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.