本页介绍了如何使用 Google Chat API 与 Google Workspace 组织中的特定用户共享 Google Chat 聊天室,以便他们可以发现并加入该聊天室。
如需指定组织中可以发现和加入聊天室的用户,您可以创建目标对象群组。目标对象群组是指您可以与之共享 Chat 聊天室的用户群组(例如特定部门或整个组织),以提高聊天室的知名度和共享能力。借助目标对象群组,您还可以管理和自定义聊天室成员,而无需邀请单个用户加入聊天室。如需了解详情,请参阅目标对象群组 简介。
您只能让命名聊天室对目标对象群组可见。您无法与其他类型的聊天室(例如私信或群组对话)共享目标对象群组。
前提条件
- 拥有可访问 Google Chat的 Google Workspace商务版或企业版账号。 您的 账号必须具有 超级用户 角色 才能管理您的 Google Workspace 组织。
- 目标对象群组可在 Chat 中访问。如需 创建目标对象群组,请参阅创建目标对象 群组。如需让现有 目标对象群组可用于 Chat 聊天室,请参阅 为 Chat 设置聊天室访问权限。
- 您必须使用 用户身份验证调用 Google Chat API。
获取目标对象群组 ID
如需获取目标对象群组的 ID,请执行以下操作:
在 Google 管理控制台中,依次点击 菜单 > 目录 > 目标对象群组。
在目标对象群组 表格中,点击目标对象群组的名称 字段。
在页面的网址中找到目标对象群组 ID。网址格式为
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID,其中TARGET_AUDIENCE_ID是目标对象群组的字母数字 ID。
在下一部分中,您将使用目标对象群组 ID 创建开放型聊天室,或更新现有聊天室以使其对目标对象群组开放。
在 Chat API 请求中指定目标对象群组
如需为特定目标对象群组创建聊天室,请对 Space 资源使用 create() 或
setup() 方法。如需让现有聊天室
可供搜索,请对 Space 资源使用 update() 方法。由于只有命名聊天室可以与目标对象群组共享,因此聊天室类型(在 spaceType 字段中表示)必须为 SPACE。
如需让聊天室可供目标对象群组搜索,请在 Space 资源中添加
AccessSettings
对象,作为 Chat API 请求的一部分。在该对象中,指定 audience 字段:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
将 TARGET_AUDIENCE_ID 替换为您在上一个部分中获取的目标对象群组的 ID。如需为 Google Workspace 组织使用默认的 Chat 聊天室共享设置,请将替换为 default。
如需详细了解如何使用 Chat API 创建或更新聊天室,请参阅以下指南: