Method: accounts.locations.transfer

  • This endpoint, now deprecated in favor of the Account Management API, enables transferring a location between accounts owned and administered by the same user.

  • To transfer, a POST request is made to the specified URL, including the location's name as a path parameter and the destination account name in the request body.

  • Successful execution results in a response containing the updated Location resource.

  • Authorization necessitates the inclusion of specific OAuth scopes, such as https://www.googleapis.com/auth/plus.business.manage or https://www.googleapis.com/auth/business.manage.

  • Users should transition to the designated Account Management API for location transfer functionality.

Moves a location from an account that the user owns to another account that the same user administers. The user must be an owner of the account the location is currently associated with and must also be at least a manager of the destination account. Returns the Location with its new resource name.

HTTP request

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:transfer

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the location to transfer.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "toAccount": string
}
Fields
toAccount

string

Name of the account resource to transfer the location to (for example, "accounts/8675309").

Response body

If successful, the response body contains an instance of Location.

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.