允許 Google Workspace 機構中的特定使用者搜尋 Google Chat 聊天室

本頁面說明如何使用 Google Chat API，與 Google Workspace 機構中的特定使用者共用 Google Chat 聊天室，方便他們尋找及加入聊天室。

如要指定貴機構中可探索及加入聊天室的使用者，請建立目標對象。目標對象是一群使用者 (例如特定部門或整個機構)，您可以與這類使用者共用 Google 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 要求的 Space 資源中加入 AccessSettings 物件。在物件中，指定 audience 欄位：

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

將 TARGET_AUDIENCE_ID 替換為您在上一個章節中取得的目標對象 ID。如要為 Google Workspace 機構使用預設的 Chat 聊天室共用設定，請將 default 取代為 。

如要瞭解如何使用 Chat API 建立或更新聊天室，請參閱下列指南：