将 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。

如需让聊天室可供目标受众群体发现，请在 Chat API 请求中将 AccessSettings 对象纳入 Space 资源中。在该对象中，指定 audience 字段：

  "accessSettings": {
    "audience": "audiences/TARGET_AUDIENCE_ID"
  }

将 TARGET_AUDIENCE_ID 替换为您在上一部分中获得的目标受众群体 ID。如需为 Google Workspace 组织使用默认的 Chat 聊天室共享设置，请替换为 default。

如需详细了解如何使用 Chat API 创建或更新聊天室，请参阅以下指南：