Method: locations.transfer

  • Transfers a location between two accounts owned/managed by the same user, requiring ownership of the origin account and at least manager status on the destination account.

  • Utilizes an HTTP POST request to https://mybusinessaccountmanagement.googleapis.com/v1/{name=locations/*}:transfer, specifying the location with {locationId} in the path.

  • The request body must contain the destinationAccount field, indicating the target account's name in the format "accounts/{account}".

  • Upon successful transfer, the response body will be empty, confirming the location's move.

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

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.

HTTP request

POST https://mybusinessaccountmanagement.googleapis.com/v1/{name=locations/*}:transfer

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. The name of the location to transfer. locations/{locationId}.

Request body

The request body contains data with the following structure:

JSON representation
{
  "destinationAccount": string
}
Fields
destinationAccount

string

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

Response body

If successful, the response body is empty.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/business.manage

For more information, see the OAuth 2.0 Overview.