将 Google Chat 聊天室设为可供 Google Workspace 组织中的特定用户检测到

本页介绍了如何使用 Google Chat API 共享 Google Chat 聊天室 与 Google Workspace 组织中的特定用户共享内容,这样他们 发现并加入聊天室。

如要指定贵组织中的哪些用户能够发现和加入聊天室,请执行以下操作: 创建目标对象群组目标对象群组是一组用户,例如 特定部门或整个组织 - 您可以共享 与 Chat 聊天室共享内容,以便提高聊天室的认知度和 共享性。借助目标对象群组,您还可以管理和自定义聊天室 而无需邀请各个用户加入聊天室。有关 请参阅关于目标 受众群体

您只能将已命名的聊天室设置为可被目标对象群组检测到。禁止的行为 分享其他类型的聊天室,例如私信或群组对话 目标受众群体。

前提条件

获取目标受众群体 ID

如需获取目标对象群组的 ID,请执行以下操作:

  1. 在 Google 管理控制台中,转到 菜单 > 目录 > 目标对象群组

    前往“目标对象群组”

  2. 目标对象群组表格中,点击目标对象群组的名称字段 受众群体。

  3. 在该网页的网址中找到目标受众群体 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 创建或更新聊天室,请参阅 以下指南: