Google Business Performance API has a
NEW API method that allows fetching multiple `DailyMetrics` in a single API request. Review the
deprecation schedule and instructions to migrate over from v4 reportInsights API method to Google Business Profile Performance API.
Method: accounts.locations.delete
Stay organized with collections
Save and categorize content based on your preferences.
Deletes a location.
Returns NOT_FOUND
if the location does not exist.
HTTP request
DELETE https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
name |
string
The name of the location to delete.
|
Request body
The request body must be empty.
Response body
If successful, the response body is empty.
Authorization Scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/plus.business.manage
https://www.googleapis.com/auth/business.manage
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-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis document explains how to delete a location using the Google My Business API.\u003c/p\u003e\n"],["\u003cp\u003eThe DELETE request requires the location's name as a path parameter and an empty request body.\u003c/p\u003e\n"],["\u003cp\u003eA successful deletion results in an empty response body, while a \u003ccode\u003eNOT_FOUND\u003c/code\u003e error indicates the location doesn't exist.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need either \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eLocations that can't be deleted via the API should be managed through the Business Profile website instead.\u003c/p\u003e\n"]]],["This document details the process of deleting a location via API. A `DELETE` request is sent to a specific URL, including the location's name in the path. The request body must be empty. A successful deletion results in an empty response body; `NOT_FOUND` is returned if the location doesn't exist. Deleting a location requires specific OAuth scopes: `plus.business.manage` or `business.manage`. There is also a specific `LocationState` to check if deleting a location through API is possible.\n"],null,["# Method: accounts.locations.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\nDeletes a location.\n\n\u003cbr /\u003e\n\n| **Note:** If this location cannot be deleted using the API as marked in the [LocationState](/my-business/reference/rest/v4/accounts.locations#Location.LocationState), use the [Business Profile](https://business.google.com/manage/) website.\n|\n| \u003cbr /\u003e\n|\n| Returns `NOT_FOUND` if the location does not exist.\n\n### HTTP request\n\n`DELETE https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------|\n| `name` | `string` The name of the location to delete. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is empty.\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]