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

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

如需管理 Google 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 将聊天室重命名为‘发布项目讨论’。”

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

为组织使用 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.search() 搭配使用时，管理员可以找到没有管理员的聊天室，然后使用 spaces.members.patch() 将现有成员提升为 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 检索管理员。