以 Google Workspace 管理员身份管理 Google Chat 聊天室

本页面简要介绍了 Google Workspace 管理员如何使用 Google Chat API 管理贵组织中的 Google Chat 聊天室。

如需管理 Chat 聊天室，Google Workspace 管理员可以使用 Google 管理控制台中的聊天室管理工具，也可以调用 Google Chat API。借助 Chat API，管理员可以创建 Google Chat 应用，以大规模管理聊天室并自动执行常规或重复性任务。

管理员可以使用 Chat API 执行哪些操作

管理员可以根据其分配的管理员角色执行管理任务。

作为 Google Workspace 管理员，您可以使用 Chat API 执行多项管理任务，例如：

如何以 Google Workspace 管理员身份进行身份验证和授权

在使用 Chat API 执行管理任务时，管理员可以通过调用管理员权限或为应用的服务账号配置全网域授权来对请求进行身份验证和授权。

下表介绍了管理员在使用 Chat API 时可以采用的身份验证方式。

用户身份验证 谁调用 API 方法 用户在 Chat 中看到的内容
管理员权限 具有 useAdminAccess=true 的管理员

“组织的管理员执行了 [操作]。”

例如，“组织的管理员将 Kiran B 更改为聊天室管理员”。

它不会标识管理员用户的姓名或用户 ID，也不会标识 Chat 应用的名称。
全网域授权 代表用户的服务账号

“[用户] 通过 [应用名称] 执行了 [操作]。”

例如，“Sasha T 将聊天室重命名为‘Release Project Discussion’”。

被服务冒充的用户会被标识为执行了相应操作。

为贵组织使用 Chat API

本部分中的示例演示了管理员如何使用 Chat API 以管理员权限管理其组织的聊天室和成员。

以下 Chat API 方法可使用 useAdminAccess=true 启用管理员权限。

管理用户的聊天室会员资格

作为 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.members.patch() 与 spaces.search() 搭配使用，查找没有管理员的聊天室，然后将现有成员提升为ROLE_MANAGER。

查找聊天室的外部成员

使用 spaces.members.list()，管理员可以检索聊天室中的成员列表，从组织的 People API 或 Directory API 检索用户个人资料，然后过滤出外部网域或组织的成员的结果。如需了解详情，请参阅聊天功能如何识别用户。

审核和管理聊天室

作为 Google Workspace 管理员，您可以通过 Chat API 执行以下场景中的操作，审核和管理贵组织中的聊天室。

查找和删除闲置聊天室

闲置的 Chat 聊天室可能会占用宝贵的存储空间，并在界面中造成杂乱。管理员可以使用 spaces.search() 查找闲置聊天室，然后使用 spaces.delete() 将其删除。如需进一步的指导和代码示例，请参阅查找和删除闲置的 Chat 聊天室。

审核组织中的聊天室

使用 spaces.search()，管理员可以检索组织中所有聊天室的列表，其中包含有关每个聊天室设置和元数据的详细信息，例如创建日期、上次活动日期、成员数量、历史记录设置的状态以及是否可以邀请外部访客。

根据搜索条件导出聊天室列表

借助 spaces.search()，管理员可以检索符合 query 中指定条件的聊天室列表，并将结果导出为 CSV 文件以供分析。

根据搜索条件查找聊天室成员

使用 spaces.members.list()，管理员可以检索组织中任何聊天室的成员列表，并按特定条件分析结果。

查找聊天室的管理员

使用 spaces.members.list()，管理员可以检索经过过滤（过滤条件为 MembershipState=ROLE_MANAGER）的聊天室的成员列表。

如需查找贵组织中所有聊天室的所有聊天室管理员，您可以使用 spaces.search() 列出所有管理员。然后，针对列表中的每个聊天室，使用 spaces.members.list 检索经理。