На этой странице представлен обзор того, как администраторы Google Workspace могут использовать API Google Chat для управления пространствами Google Chat в своей организации.
Для управления чат-пространствами администраторы Google Workspace могут использовать инструмент управления пространством в консоли администратора Google или вызвать API Google Chat. С помощью API Chat администраторы могут создавать приложения Google Chat для масштабного управления пространствами и автоматизировать выполнение стандартных или повторяющихся задач.
Что администраторы могут делать с API чата
Администратор может выполнять задачи управления на основе назначенных ему ролей администратора .
Как администратор Google Workspace вы можете выполнять ряд задач по управлению с помощью API чата, например:
- Поиск мест на основе заданных критериев
- Список участников пространства
- Добавлять и удалять участников из пространства
- Получите подробную информацию об участнике и пространстве
- Обновить или удалить пространство
- Обновить членство пользователя
Как пройти аутентификацию и авторизацию в качестве администратора Google Workspace
При использовании API чата для задач управления администраторы могут аутентифицировать и авторизовать запросы, используя привилегии администратора или настраивая делегирование полномочий на уровне домена для учетной записи службы приложения.
В следующей таблице описаны способы аутентификации администраторов при использовании API чата.
| Аутентификация пользователя | Кто вызывает метод API | Что пользователи видят в чате |
|---|---|---|
| Права администратора | Администратор с useAdminAccess=true | «Администратор организации выполнил [действие]». Например, «Администратор организации назначил Киран Б. менеджером по работе с клиентами». Он не идентифицирует имя администратора или идентификатор пользователя, а также имя приложения чата. |
| Делегирование на уровне всего домена | Учетная запись службы от имени пользователя | «[Пользователь] выполнил [действие] через [название приложения]». Например, «Саша Т. переименовал раздел в „Обсуждение проекта релиза“». Пользователь, от имени которого действует служба, идентифицируется как выполнивший действие. |
Используйте API чата для вашей организации
Примеры в этом разделе демонстрируют, как администраторы используют API чата при управлении пространствами и участниками своей организации с правами администратора .
Следующие методы 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, можете управлять членством пользователей в пространстве в вашей организации с помощью 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 или API Directory организации, а затем отфильтровать результаты, выбрав участников внешнего домена или организации. Подробнее см. в статье «Как чат идентифицирует пользователей» .
Аудит и управление пространствами
Ниже приведены сценарии, с помощью которых вы, как администратор Google Workspace, можете проводить аудит и управление пространствами в вашей организации с помощью 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 с помощью API Google Chat в качестве администратора Google Workspace
- метод
spaces.search()