rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
Get the latest
on new Merchant API features, bug fixes, and updates.
add_alert
Note: Content API for Shopping will be sunset on August 18, 2026.
Method: regions.patch
Stay organized with collections
Save and categorize content based on your preferences.
Updates a region definition in your Merchant Center account.
HTTP request
PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/regions/{regionId}
Path parameters
Parameters |
merchantId |
string (int64 format)
Required. The id of the merchant for which to update region definition.
|
regionId |
string
Required. The id of the region to update.
|
Query parameters
Parameters |
updateMask |
string (FieldMask format)
Optional. The comma-separated field mask indicating the fields to update. Example: "displayName,postalCodeArea.regionCode" .
|
Request body
The request body contains an instance of Region
.
Response body
If successful, the response body contains an instance of Region
.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-02-25 UTC.
[null,null,["Last updated 2025-02-25 UTC."],[[["\u003cp\u003eThis operation updates a region definition within your Merchant Center account using an HTTP PATCH request.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide the \u003ccode\u003emerchantId\u003c/code\u003e and \u003ccode\u003eregionId\u003c/code\u003e as path parameters to identify the specific region.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, use the \u003ccode\u003eupdateMask\u003c/code\u003e query parameter to specify the fields you want to update in the region definition.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should contain a \u003ccode\u003eRegion\u003c/code\u003e object with the updated information, and a successful response will also return a \u003ccode\u003eRegion\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using OAuth 2.0 with the \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This document details how to update a region definition within a Merchant Center account using a PATCH request. The request URL is specified with `merchantId` and `regionId` as required path parameters. The `updateMask` query parameter optionally dictates which fields to modify. The request body includes a `Region` instance, and a successful response returns an updated `Region` instance. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: regions.patch\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a region definition in your Merchant Center account.\n\n### HTTP request\n\n`PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/regions/{regionId}`\n\n### Path parameters\n\n| Parameters ||\n|--------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The id of the merchant for which to update region definition. |\n| `regionId` | `string` Required. The id of the region to update. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Optional. The comma-separated field mask indicating the fields to update. Example: `\"displayName,postalCodeArea.regionCode\"`. |\n\n### Request body\n\nThe request body contains an instance of [Region](/shopping-content/reference/rest/v2.1/regions#Region).\n\n### Response body\n\nIf successful, the response body contains an instance of [Region](/shopping-content/reference/rest/v2.1/regions#Region).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]