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: accounts.delete
Stay organized with collections
Save and categorize content based on your preferences.
Deletes a Merchant Center sub-account.
HTTP request
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}
Path parameters
| Parameters |
merchantId |
string
The ID of the managing account. This must be a multi-client account, and accountId must be the ID of a sub-account of this account.
|
accountId |
string
The ID of the account.
|
Query parameters
| Parameters |
force |
boolean
Option to delete sub-accounts with products. The default value is false.
|
Request body
The request body must be empty.
Response body
If successful, the response body is an empty JSON object.
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 deletes a Merchant Center sub-account using an HTTP DELETE request.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the managing account ID and the sub-account ID as path parameters.\u003c/p\u003e\n"],["\u003cp\u003eAn optional query parameter \u003ccode\u003eforce\u003c/code\u003e allows deleting sub-accounts even if they have products.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is necessary using OAuth scopes, specifically \u003ccode\u003ehttps://www.googleapis.com/auth/content\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, and a successful deletion results in an empty response body.\u003c/p\u003e\n"]]],["This document details the process of deleting a Merchant Center sub-account. The `DELETE` HTTP request is made to the specified URL, including the `merchantId` (managing account's ID) and `accountId` (sub-account's ID) as path parameters. An optional query parameter, `force`, allows deleting sub-accounts containing products. The request body must be empty. A successful operation returns an empty JSON object. Authorization requires the `https://www.googleapis.com/auth/content` OAuth scope.\n"],null,["# Method: accounts.delete\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\nDeletes a Merchant Center sub-account.\n\n### HTTP request\n\n`DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}`\n\n### Path parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `merchantId` | `string` The ID of the managing account. This must be a multi-client account, and [accountId](#accountId) must be the ID of a sub-account of this account. |\n| `accountId` | `string` The ID of the account. |\n\n### Query parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------------------------------|\n| `force` | `boolean` Option to delete sub-accounts with products. The default value is false. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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)."]]