The Business Profile Performance API is now launched! Migration work is required.
Review the deprecation schedule and instructions to migrate over to new v1 APIs from older deprecated v4 API.
Help us improve the food menu experience by filling in this survey to better understand what place, menu, and dish attributes you can provide about the merchants you support

Work with account data

Stay organized with collections Save and categorize content based on your preferences.

This tutorial shows you how to work with account data. The My Business Account Management API provides you with the ability to do the following:

  • List all accounts.
  • Return a specific account.
  • Update an account.

Before you begin

Before you use the My Business Account Management API, you need to register your application and obtain OAuth 2.0 credentials.

For details on how to get started with the Business Profile APIs, see Basic setup.

List all accounts

A great way to validate the accounts associated with an authenticated user is to list all their accounts. Use the accounts.list API to list all accounts associated with a user.

To list all the accounts for an authenticated user, use the following:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Return a specific account

Sometimes, you only want to see information about a specific account for an authenticated user. Use the accounts.get API to return a specific account and review additional account details.

To return a specific account by name, use the following:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Update an account

Changing an account name is a fundamental administrative task. Use the accounts.update API to alter the account name.

To update a specific account by name, use the following:

HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

Restrictions

  • The only editable field for an account is accountName. Any other fields passed are ignored.
  • Only accounts of BUSINESS type can be updated in this manner.