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

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

如要指定貴機構中可以探索及加入聊天室的使用者，請建立目標對象。目標對象是指可與特定使用者共用 Chat 聊天室的一群使用者 (例如特定部門或整個機構)，以提升聊天室的認識和共用能力。此外，目標對像功能可讓您管理及自訂聊天室成員資格，而不必邀請個別使用者加入聊天室。詳情請參閱「關於目標對象」。

您只能將已命名的聊天室設為可供目標對象搜尋。您無法與目標對象共用其他聊天室類型，例如即時訊息或群組對話。

先備知識

取得目標對象 ID

如要取得目標對象的 ID，請按照下列步驟操作：

  1. 在 Google 管理控制台中，依序前往「Menu」(選單) >「Directory」(目錄) >「Target Audience」(目標對象)。

    前往「目標對象」頁面

  2. 在「Target audiences」(目標對象) 表格中，按一下目標對象的「Name」(名稱) 欄位。

  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 建立或更新聊天室，請參閱下列指南：