Method: accounts.list
bookmark_borderbookmark
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Перечисляет все учетные записи для аутентифицированного пользователя. Сюда входят все учетные записи, которыми владеет пользователь, а также любые учетные записи, для которых у пользователя есть права управления.
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 .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-01-05 UTC.
[[["Прост для понимания","easyToUnderstand","thumb-up"],["Помог мне решить мою проблему","solvedMyProblem","thumb-up"],["Другое","otherUp","thumb-up"]],[["Отсутствует нужная мне информация","missingTheInformationINeed","thumb-down"],["Слишком сложен/слишком много шагов","tooComplicatedTooManySteps","thumb-down"],["Устарел","outOfDate","thumb-down"],["Проблема с переводом текста","translationIssue","thumb-down"],["Проблемы образцов/кода","samplesCodeIssue","thumb-down"],["Другое","otherDown","thumb-down"]],["Последнее обновление: 2025-01-05 UTC."],[[["Lists all accounts owned by or accessible to the authenticated user, including their personal account."],["Allows filtering accounts by type and specifying the parent account for retrieval."],["Supports pagination to retrieve large lists of accounts using `pageToken`."],["The response includes an array of `Account` objects and a `nextPageToken` for further results."],["Requires the `https://www.googleapis.com/auth/business.manage` OAuth scope for authorization."]]],["This API retrieves a list of accounts for an authenticated user via a `GET` request to a specified URL. The user can filter the accounts by type, specify the page size, and use a `pageToken` for pagination. An optional `parentAccount` parameter retrieves accounts directly accessible from that account. The request body must be empty, and the successful response includes an array of account objects and, if applicable, a `nextPageToken` for further pagination. This uses OAuth 2.0 with the `business.manage` scope.\n"]]