Method: accounts.list

Перечисляет все учетные записи для аутентифицированного пользователя. Сюда входят все учетные записи, которыми владеет пользователь, а также любые учетные записи, для которых у пользователя есть права управления.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры запроса

Параметры
parentAccount

string

Необязательный. Имя ресурса учетной записи, для которой необходимо получить список учетных записей с прямым доступом. Это имеет смысл только для организаций и групп пользователей. Если пусто, вернет accounts.list для аутентифицированного пользователя. accounts/{account_id} .

pageSize

integer

Необязательный. Сколько аккаунтов нужно получить на страницу. По умолчанию и максимум — 20.

pageToken

string

Необязательный. Если указано, извлекается следующая страница учетных записей. pageToken возвращается, когда вызов accounts.list возвращает больше результатов, чем может поместиться в запрошенный размер страницы.

filter

string

Необязательный. Фильтр, ограничивающий возврат учетных записей. Ответ включает только записи, соответствующие фильтру. Если filter пуст, ограничения не применяются, и для запрошенной учетной записи извлекаются все учетные записи (с разбивкой на страницы).

Например, запрос с type=USER_GROUP вернет только группы пользователей.

Поле type — единственный поддерживаемый фильтр.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

Ответное сообщение для Accounts.ListAccounts.

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Поля
accounts[]

object ( Account )

Коллекция учетных записей, к которым у пользователя есть доступ. Личный аккаунт пользователя, выполняющего запрос, всегда будет первым элементом результата, если он не отфильтрован.

nextPageToken

string

Если количество учетных записей превышает запрошенный размер страницы, это поле заполняется токеном для получения следующей страницы учетных записей при последующем accounts.list . Если учетных записей больше нет, это поле отсутствует в ответе.

Области авторизации

Требуется следующая область действия OAuth:

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

Дополнительную информацию см. в обзоре OAuth 2.0 .