Method: accounts.regions.batchDelete
Stay organized with collections
Save and categorize content based on your preferences.
Deletes multiple regions by name from your Merchant Center account. Executing this method requires admin access.
HTTP request
POST https://merchantapi.googleapis.com/accounts/v1/{parent=accounts/*}/regions:batchDelete
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The account to delete one or more regions from. Format: accounts/{account}
|
Request body
The request body contains data with the following structure:
| Fields |
requests[] |
object (DeleteRegionRequest)
Required. The names of the regions to delete. A maximum of 100 regions can be deleted in a batch.
|
Response body
If successful, the response body is an empty JSON object.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/content
For more information, see the OAuth 2.0 Overview.
DeleteRegionRequest
Request message for the regions.delete method.
| JSON representation |
{
"name": string
} |
| Fields |
name |
string
Required. The name of the region to delete. Format: accounts/{account}/regions/{region}
|
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-09-03 UTC.
[null,null,["Last updated 2025-09-03 UTC."],[],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [DeleteRegionRequest](#DeleteRegionRequest)\n - [JSON representation](#DeleteRegionRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nDeletes multiple regions by name from your Merchant Center account. Executing this method requires admin access.\n\nHTTP request\n\n`POST https://merchantapi.googleapis.com/accounts/v1/{parent=accounts/*}/regions:batchDelete`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\nPath parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The account to delete one or more regions from. Format: `accounts/{account}` |\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/merchant/api/reference/rest/accounts_v1/accounts.regions/batchDelete#DeleteRegionRequest) } ] } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[DeleteRegionRequest](/merchant/api/reference/rest/accounts_v1/accounts.regions/batchDelete#DeleteRegionRequest)`)` Required. The names of the regions to delete. A maximum of 100 regions can be deleted in a batch. |\n\nResponse body\n\nIf successful, the response body is an empty JSON object.\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/content`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nDeleteRegionRequest Request message for the `regions.delete` method.\n\n| JSON representation |\n|----------------------------|\n| ``` { \"name\": string } ``` |\n\n| Fields ||\n|--------|----------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the region to delete. Format: `accounts/{account}/regions/{region}` |"]]
