本页介绍了如何使用 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
。
如需让聊天室可供目标受众群体发现,请在 Chat API 请求中将 AccessSettings
对象纳入 Space
资源中。在该对象中,指定 audience
字段:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
将 TARGET_AUDIENCE_ID
替换为您在上一部分中获得的目标受众群体 ID。如需为 Google Workspace 组织使用默认的 Chat 聊天室共享设置,请替换为 default
。
如需详细了解如何使用 Chat API 创建或更新聊天室,请参阅以下指南: