本页介绍了如何使用 Google Chat API 共享 Google Chat 聊天室 与 Google Workspace 组织中的特定用户共享内容,这样他们 发现并加入聊天室。
如要指定贵组织中的哪些用户能够发现和加入聊天室,请执行以下操作: 创建目标对象群组目标对象群组是一组用户,例如 特定部门或整个组织 - 您可以共享 与 Chat 聊天室共享内容,以便提高聊天室的认知度和 共享性。借助目标对象群组,您还可以管理和自定义聊天室 而无需邀请各个用户加入聊天室。有关 请参阅关于目标 受众群体。
您只能将已命名的聊天室设置为可被目标对象群组检测到。禁止的行为 分享其他类型的聊天室,例如私信或群组对话 目标受众群体。
前提条件
- Business 或 Enterprise 有权访问以下内容的 Google Workspace 账号: Google Chat。 您的 账号必须拥有超级用户 角色 。
- 可在 Chat 中访问的目标对象群组。接收者 创建目标对象群组,请参阅创建目标对象群组 受众群体。要创建现有的 Chat 聊天室可用的目标对象群组,请参阅 为 Chat 设置聊天室访问权限。
获取目标受众群体 ID
如需获取目标对象群组的 ID,请执行以下操作:
在 Google 管理控制台中,转到 菜单> 目录 > 目标对象群组。
在目标对象群组表格中,点击目标对象群组的名称字段 受众群体。
在该网页的网址中找到目标受众群体 ID。网址格式为
https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID
, 其中TARGET_AUDIENCE_ID
是 目标受众群体。
在下一部分中,您将使用目标受众群体 ID 创建 开放型聊天室,或者更新现有聊天室,将其设为可由 目标受众群体。
在 Chat API 请求中指定目标对象群组
如需为特定目标对象群组创建聊天室,请使用create()
或
针对 Space
资源调用 setup()
方法。要创建现有聊天室,请执行以下操作:
请对 Space
资源使用 update()
方法。因为只有
可以与目标对象群组、聊天室类型
(在 spaceType
字段中表示)必须为 SPACE
。
如要将聊天室设为向目标受众群体开放,请添加
AccessSettings
对象包含在 Space
资源中。在
该对象,请指定 audience
字段:
"accessSettings": {
"audience": "audiences/TARGET_AUDIENCE_ID"
}
将 TARGET_AUDIENCE_ID
替换为目标的 ID
您在上一部分中获取的受众群体。要使用默认值
Google Workspace 的 Chat 聊天室共享设置
组织,替换为 default
。
如需详细了解如何使用 Chat API 创建或更新聊天室,请参阅 以下指南: