Method: users.watch

Отслеживает изменения в списке пользователей.

HTTP-запрос

POST https://admin.googleapis.com/admin/directory/v1/users/watch

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

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

Параметры
domain

string

Имя домена. Заполните это поле, чтобы получить пользователей только из этого домена. Чтобы вернуть всех пользователей в многодоменном поле, заполните поле клиента».

customer

string

Неизменяемый идентификатор аккаунта Google Workspace. В случае нескольких доменов, чтобы получить всех пользователей для клиента, заполните это поле вместо домена.

event

enum ( EventType )

События, за которыми стоит следить.

customFieldMask

string

Список имен схем, разделенных запятыми. Все поля из этих схем извлекаются. Это значение следует устанавливать только в том случае, если проекция = custom.

maxResults

integer

Максимальное количество возвращаемых результатов.

orderBy

enum ( OrderBy )

Столбец, используемый для сортировки результатов

pageToken

string

Токен для указания следующей страницы в списке

projection

enum ( Projection )

Какое подмножество полей получить для этого пользователя.

query

string

Поиск строки запроса. Должно быть вида " Полная документация находится по адресу https://developers.google.com/admin-sdk/directory/v1/guides/search-users.

showDeleted

string

Если установлено значение true, извлекается список удаленных пользователей. (По умолчанию: ложь)

sortOrder

enum ( SortOrder )

Возвращать ли результаты в порядке возрастания или убывания.

viewType

enum ( ViewType )

Следует ли получать общедоступное представление пользователя только для администратора или для всего домена. Дополнительные сведения см. в разделе Получение пользователя без прав администратора .

Тело запроса

Тело запроса содержит экземпляр SubscriptionChannel .

Тело ответа

В случае успеха тело ответа содержит экземпляр SubscriptionChannel .

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

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/admin.directory.user
  • https://www.googleapis.com/auth/admin.directory.user.readonly
  • https://www.googleapis.com/auth/cloud-platform

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

Тип события

Тип события подписки

Перечисления
ADD Созданное пользователем событие
DELETE Событие, удаленное пользователем
MAKE_ADMIN Событие изменения статуса администратора пользователя
UNDELETE Событие восстановления пользователя
UPDATE Событие, обновленное пользователем

Сортировать по

Перечисления
EMAIL Основной адрес электронной почты пользователя.
FAMILY_NAME Фамилия пользователя.
GIVEN_NAME Имя пользователя.

Проекция

Перечисления
BASIC Не включайте никаких настраиваемых полей для пользователя.
CUSTOM Включите настраиваемые поля из схем, упомянутых в customFieldMask.
FULL Включите все поля, связанные с этим пользователем.

Порядок сортировки

Перечисления
ASCENDING Восходящий порядок.
DESCENDING В порядке убывания.

Тип просмотра

Перечисления
admin_view Результаты включают как поля, доступные только администратору, так и поля, общедоступные для домена.
domain_public Результаты включают только поля для пользователя, которые публично видны другим пользователям в домене.