Method: accounts.delete

  • Deletes a specified account, including standalone, MCA, and sub-accounts, requiring admin access.

  • Deletion is conditional on the account not serving others or having processed offers, unless overridden with the force parameter.

  • The request is sent as a DELETE method to the provided URL with the account name as a path parameter and optional force query parameter.

  • The request body is empty, and a successful response returns an empty JSON object.

  • Requires the https://www.googleapis.com/auth/content OAuth scope for authorization.

Deletes the specified account regardless of its type: standalone, advanced account or sub-account. Deleting an advanced account leads to the deletion of all of its sub-accounts. Executing this method requires admin access. The deletion succeeds only if the account does not provide services to any other account and has no processed offers. You can use the force parameter to override this.

HTTP request

DELETE https://merchantapi.googleapis.com/accounts/v1beta/{name=accounts/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the account to delete. Format: accounts/{account}

Query parameters

Parameters
force

boolean

Optional. If set to true, the account is deleted even if it provides services to other accounts or has processed offers.

Request body

The request body must be empty.

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.