<br />

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](https://developers.google.com/my-business/content/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`](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/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`](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/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`](https://developers.google.com/my-business/reference/accountmanagement/rest/v1/accounts/patch)
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.