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

本页面介绍了如何使用 Google Chat API 与 Google Workspace 组织中的特定用户共享 Google Chat 聊天室,以便他们可以发现和加入该聊天室。

如需指定组织中可以发现和加入聊天室的用户,您可以创建目标对象群组。目标对象群组是您可以与之共享 Chat 聊天室的一组人员(例如特定部门或整个组织),从而提高聊天室的认知度和共享性。借助目标对象群组,您还可以管理和自定义聊天室的成员资格,而无需邀请个别用户加入聊天室。如需了解详情,请参阅目标对象群组简介

您只能将已命名的聊天室设置为可被目标对象群组检测到。您无法与目标对象群组共享其他类型的聊天室,例如私信或群组对话。

前提条件

获取目标受众群体 ID

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

  1. 在 Google 管理控制台中,依次点击菜单 > 目录 > 目标对象群组

    前往“目标对象群组”

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

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