Attention: There will be major changes to the API soon that will require migration work. Please check our upcoming releases page and deprecation schedule frequently for updates. You may also sign up for our mailing list to receive updates.

My Business Account Management API

The My Business Account Management API provides an interface for managing access to a location on Google.

Service: mybusinessaccountmanagement.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://mybusinessaccountmanagement.googleapis.com

REST Resource: v1.accounts

Methods
create POST /v1/accounts
Creates an account with the specified name and type under the given parent.
get GET /v1/{name=accounts/*}
Gets the specified account.
list GET /v1/accounts
Lists all of the accounts for the authenticated user.
patch PATCH /v1/{account.name=accounts/*}
Updates the specified business account.

REST Resource: v1.accounts.admins

Methods
create POST /v1/{parent=accounts/*}/admins
Invites the specified user to become an administrator for the specified account.
delete DELETE /v1/{name=accounts/*/admins/*}
Removes the specified admin from the specified account.
list GET /v1/{parent=accounts/*}/admins
Lists the admins for the specified account.
patch PATCH /v1/{accountAdmin.name=accounts/*/admins/*}
Updates the Admin for the specified Account Admin.

REST Resource: v1.accounts.invitations

Methods
accept POST /v1/{name=accounts/*/invitations/*}:accept
Accepts the specified invitation.
decline POST /v1/{name=accounts/*/invitations/*}:decline
Declines the specified invitation.
list GET /v1/{parent=accounts/*}/invitations
Lists pending invitations for the specified account.

REST Resource: v1.locations

Methods
transfer POST /v1/{name=locations/*}:transfer
Moves a location from an account that the user owns to another account that the same user administers.

REST Resource: v1.locations.admins

Methods
create POST /v1/{parent=locations/*}/admins
Invites the specified user to become an administrator for the specified location.
delete DELETE /v1/{name=locations/*/admins/*}
Removes the specified admin as a manager of the specified location.
list GET /v1/{parent=locations/*}/admins
Lists all of the admins for the specified location.
patch PATCH /v1/{locationAdmin.name=locations/*/admins/*}
Updates the Admin for the specified location.