Marks target Account as soft-deleted (ie: "trashed") and returns it.
This API does not have a method to restore soft-deleted accounts. However, they can be restored using the Trash Can UI.
If the accounts are not restored before the expiration time, the account and all child resources (eg: Properties, GoogleAdsLinks, Streams, AccessBindings) will be permanently purged. https://support.google.com/analytics/answer/6154772
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-14 UTC."],[[["\u003cp\u003eThis API request soft-deletes a specified Google Analytics 4 account, essentially moving it to the trash.\u003c/p\u003e\n"],["\u003cp\u003eSoft-deleted accounts and their associated data are permanently deleted after a certain time period, unless restored through the Trash Can UI.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the \u003ccode\u003eanalytics.edit\u003c/code\u003e scope for authorization and uses a \u003ccode\u003eDELETE\u003c/code\u003e request with the account name as a path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThere's no specific API method to restore deleted accounts; restoration is handled via the Google Analytics UI.\u003c/p\u003e\n"],["\u003cp\u003eIf the targeted account is not found, the request will return an error.\u003c/p\u003e\n"]]],["This API endpoint soft-deletes an account via a `DELETE` request to `https://analyticsadmin.googleapis.com/v1alpha/{name=accounts/*}`, where `name` is the account identifier (e.g., \"accounts/100\"). The request body must be empty. A successful operation returns an empty JSON object, and the action requires the `https://www.googleapis.com/auth/analytics.edit` OAuth scope. Soft-deleted accounts are recoverable via the Trash Can UI but will be permanently purged after an expiration period if not restored. The API does not contain a method to restore an account. An error will be returned if the account is not found.\n"],null,["# Method: accounts.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nMarks target Account as soft-deleted (ie: \"trashed\") and returns it.\n\nThis API does not have a method to restore soft-deleted accounts. However, they can be restored using the Trash Can UI.\n\nIf the accounts are not restored before the expiration time, the account and all child resources (eg: Properties, GoogleAdsLinks, Streams, AccessBindings) will be permanently purged. \u003chttps://support.google.com/analytics/answer/6154772\u003e\n\nReturns an error if the target is not found.\n\n### HTTP request\n\n`DELETE https://analyticsadmin.googleapis.com/v1alpha/{name=accounts/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the Account to soft-delete. Format: accounts/{account} Example: \"accounts/100\" |\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 the following OAuth scope:\n\n- `https://www.googleapis.com/auth/analytics.edit`"]]
