将 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 创建或更新聊天室,请参阅以下指南: