Method: accounts.productInputs.patch

Updates the existing product input in your Merchant Center account.

After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

HTTP request

PATCH https://merchantapi.googleapis.com/products/v1beta/{productInput.name=accounts/*/productInputs/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
productInput.name

string

Identifier. The name of the product input. Format: accounts/{account}/productInputs/{productinput} where the last section productinput consists of: contentLanguage~feedLabel~offerId example for product input name is accounts/123/productInputs/en~US~sku123. A legacy local product input name would be accounts/123/productInputs/local~en~US~sku123. Note: For calls to the v1beta version, the productInput section consists of: channel~contentLanguage~feedLabel~offerId, for example: accounts/123/productInputs/online~en~US~sku123.

Query parameters

Parameters
updateMask

string (FieldMask format)

Optional. The list of product attributes to be updated.

If the update mask is omitted, then it is treated as implied field mask equivalent to all fields that are populated (have a non-empty value).

Attributes specified in the update mask without a value specified in the body will be deleted from the product.

Update mask can only be specified for top level fields in attributes and custom attributes.

To specify the update mask for custom attributes you need to add the custom_attribute. prefix.

Providing special "*" value for full product replacement is not supported.

dataSource

string

Required. The primary or supplemental product data source where dataSource name identifies the product input to be updated.

Only API data sources are supported.

Format: accounts/{account}/dataSources/{datasource}. For example, accounts/123456/dataSources/104628.

productIdBase64UrlEncoded

boolean

Optional. If true, the {productInput} in the name field of the request will be interpreted as unpadded base64url-encoded and decoded during request processing to match the decoded value. Default value is false. Use this if your {productInput} contains special characters, such as forward slash / or other characters that are unpadded base64url-encoded (as per RFC 7515: https://datatracker.ietf.org/doc/html/rfc7515#section-2).

Note that future versions of the API will only accept unpadded base64url-encoded product ids, so we strongly recommend proactively setting this to true and encoding the product ids.

Request body

The request body contains an instance of ProductInput.

Response body

If successful, the response body contains an instance of ProductInput.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.