Как работать с данными аккаунтов

В этом руководстве рассказывается, как работать с данными аккаунтов. С помощью My Business Account Management API можно выполнить следующие действия:

  • Получить список всех аккаунтов.
  • Получить данные определенного аккаунта.
  • Обновить данные об аккаунте.

Подготовка

Прежде чем начинать работу с My Business Account Management API, зарегистрируйте свое приложение и получите учетные данные OAuth 2.0.

Подробнее о начале работы с Business Profile API

Как получить список всех аккаунтов

Проверить все аккаунты, связанные с пользователем, выполнившим аутентификацию, проще всего, запросив их полный список. Для этого воспользуйтесь API accounts.list.

Выполните следующие действия:

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

Как получить данные определенного аккаунта

Иногда вам необходимо получить сведения только о конкретном аккаунте, который связан с пользователем, выполнившим аутентификацию. Воспользуйтесь API accounts.get, чтобы получить подробную информацию об аккаунте.

Выполните следующие действия:

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

Как обновить данные об аккаунте

Изменение названия аккаунта – важная задача для администратора. Для этого нужно использовать API accounts.update.

Выполните следующие действия:

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

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

Ограничения

  • Единственное редактируемое поле для аккаунта – accountName. Все остальные передаваемые поля игнорируются.
  • Обновлять таким образом можно только данные об аккаунтах типа BUSINESS.