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

本頁面說明如何使用 Google Chat API 共用 Google Chat 聊天室 共用 Google Workspace 機構中的特定使用者,讓使用者 探索並加入聊天室

如要指定貴機構中可以探索及加入聊天室的使用者,請按照下列步驟操作: 您需要建立目標對象目標對象是指一群使用者,例如 可由特定部門或整個機構共用 與 Chat 聊天室合作,以提升聊天室的辨識能力, 分享關係目標對像也可讓您管理及自訂聊天室 不必邀請個別使用者加入聊天室。如要 相關資訊,請參閱關於目標 目標對象

您只能將已命名的聊天室設為可供目標對象搜尋。禁止事項 與共享其他聊天室類型 (例如即時訊息或群組對話) 分享 目標對象

必要條件

取得目標對象 ID

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

  1. 在 Google 管理控制台中,前往 選單 > 目錄 > 目標對象

    前往「目標對象」頁面

  2. 在「目標對象」表格中,按一下指定目標的「名稱」欄位 目標對象

  3. 在網頁網址中找到目標對象 ID。網址格式為 https://admin.google.com/ac/targetaudiences/TARGET_AUDIENCE_ID, 其中 TARGET_AUDIENCE_ID 是英數字元 ID 目標對象

在下一節中,您將使用目標對象 ID 可自由加入的聊天室,或是更新現有聊天室,使其可供搜尋 目標對象

在 Chat API 要求中指定目標對象

如要為特定目標對象建立聊天室,請使用create()Space 資源上的 setup() 方法。建立現有聊天室 可以找到,請對 Space 資源使用 update() 方法。因為 已命名的聊天室可與目標對象 (聊天室類型) 共用 (在 spaceType 欄位中表示) 必須為 SPACE

如要讓目標對象可以搜尋聊天室,請加入 AccessSettings 物件,只要做為 Chat API 要求的一部分即可。Space於 請在物件中指定 audience 欄位:

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

TARGET_AUDIENCE_ID 替換為目標 ID 獲得多少目標對象如何使用預設值 Google Workspace 的 Chat 聊天室共用設定 「default」。

如要進一步瞭解如何使用 Chat API 建立或更新聊天室,請參閱 下列指南: