На этой странице представлен обзор того, как администраторы Google Workspace могут использовать API Google Chat для управления пространствами Google Chat в своей организации.
Для управления пространствами чата администраторы Google Workspace могут использовать инструмент управления пространством в консоли администратора Google или вызвать API Google Chat. Используя Chat API, администраторы могут создавать приложения Google Chat, которые управляют пространствами в большом масштабе и автоматизируют общие или повторяющиеся задачи.
Что администраторы могут делать с помощью Chat API
Администратор может выполнять задачи управления в соответствии с назначенными ему ролями администратора .
Как администратор Google Workspace, вы можете выполнять ряд задач управления с помощью Chat API, например следующие:
- Поиск пространств по заданным критериям
- Список участников пространства
- Добавляйте участников и удаляйте участников из пространства
- Получите подробную информацию об участнике и пространстве
- Обновить или удалить пространство
- Обновить членство пользователя
Как пройти аутентификацию и авторизоваться в качестве администратора Google Workspace
При использовании Chat API для задач управления администраторы могут аутентифицировать и авторизовать запросы, вызывая привилегии администратора или настраивая делегирование полномочий на уровне домена для сервисной учетной записи приложения.
В следующей таблице описаны способы аутентификации администраторов при использовании Chat API.
| Аутентификация пользователя | Кто вызывает метод API | Что пользователи видят в чате |
|---|---|---|
| Права администратора | Администратор с useAdminAccess=true | «Администратор организации совершил [действие]». Например, «Администратор организации назначил Киран Б менеджером по пространству». Он не идентифицирует имя или идентификатор пользователя-администратора, а также имя приложения чата. |
| Делегирование по всему домену | Учетная запись службы от имени пользователя | «[Пользователь] выполнил [действие] через [имя приложения]». Например, «Саша Т. переименовала это пространство в Обсуждение проекта выпуска». Пользователь, которого олицетворяет служба, идентифицируется как выполнивший действие. |
Используйте API чата для своей организации
Примеры в этом разделе демонстрируют, как администраторы используют Chat API при управлении пространствами и участниками своей организации с правами администратора .
Следующие методы Chat API предоставляют права администратора с помощью useAdminAccess=true .
-
spaces.delete() -
spaces.get() -
spaces.patch() -
spaces.search() -
spaces.members.create() -
spaces.members.delete() -
spaces.members.get() -
spaces.members.list() -
spaces.members.patch()
Управление членством пользователей в пространствах
В следующих сценариях вы, как администратор Google Workspace, можете управлять членством пользователей в вашей организации с помощью Chat API.
Добавляйте пользователей в пространства
Используя spaces.members.create() администраторы могут добавить пользователя в любое пространство в организации.
При использовании совместно с spaces.search() администраторы могут добавлять пользователя в набор пространств, определенный их поисковым запросом. Это может быть полезно при приеме новых сотрудников в организацию; это позволяет администраторам автоматизировать рутинный процесс.
Находите пользователей и удаляйте их из пространств
Используя spaces.members.get() администраторы могут определить, является ли пользователь (внутренний или внешний по отношению к организации) членом какого-либо пространства в организации.
При использовании в сочетании с spaces.search() администраторы могут найти все пространства, участником которых является пользователь, а затем удалить их из пространств с помощью spaces.members.delete() . Это может быть полезно, когда сотрудники перемещают команды внутри организации или увольняют сотрудников, которые больше не работают в организации; это позволяет администраторам автоматизировать рутинный процесс.
Назначьте пользователей менеджером пространства
Используя spaces.members.patch() , администраторы могут повышать участников пространства с ROLE_MEMBER до ROLE_MANAGER . Администраторы также могут использовать spaces.members.patch() для перемещения участников из ROLE_MANAGER в ROLE_MEMBER .
При использовании в сочетании с spaces.search() администраторы могут находить пространства, у которых нет менеджера, а затем повышать существующего участника до ROLE_MANAGER с помощью spaces.members.patch() .
Найти внешних участников пространства
Используя spaces.members.list() , администраторы могут получить список участников в пространстве, получить профили пользователей из API People или Directory API организации, а затем отфильтровать результаты для тех, кто является членами внешнего домена или организации. Дополнительные сведения см. в разделе Как чат идентифицирует пользователей .
Аудит и управление помещениями
В следующих сценариях вы, как администратор Google Workspace, можете проверять пространства в своей организации и управлять ими с помощью Chat API.
Найдите и удалите неактивные места
Неиспользуемые пространства чата могут занимать ценное пространство для хранения и создавать беспорядок в пользовательском интерфейсе. Администраторы могут использовать spaces.search() для поиска неактивных пространств, а затем spaces.delete() для их удаления. Дополнительные инструкции и пример кода см. в разделе Поиск и удаление неактивных пространств чата .
Пространства аудита в организации
Используя spaces.search() , администраторы могут получить список всех пространств в организации с подробной информацией о настройках и метаданных каждого пространства, таких как дата создания, дата последней активности, количество участников, состояние настроек истории и возможность приглашать внешних пользователей. гости.
Экспортировать список пространств на основе критериев поиска
Используя spaces.search() администраторы могут получить список пространств, соответствующих критериям, указанным в query , и экспортировать результаты в файл CSV для анализа.
Находите участников пространства по критериям поиска
Используя spaces.members.list() администраторы могут получить список участников любого пространства в организации и проанализировать результаты по определенным критериям.
Найдите менеджеров пространства
Используя spaces.members.list() , администраторы могут получить список участников пространства, которое отфильтровано по MembershipState=ROLE_MANAGER .
Чтобы найти всех менеджеров пространств в вашей организации во всех пространствах, вы можете использовать spaces.search() чтобы перечислить их все. Затем для каждого пространства в списке используйте spaces.members.list для получения менеджеров.
Связанные темы
- Аутентификация и авторизация с использованием прав администратора
- Ищите пространства Google Chat и управляйте ими с помощью Google Chat API в качестве администратора Google Workspace.
- метод
spaces.search()