本頁面說明如何使用 Google Chat API 與 Google Workspace 機構中的特定使用者共用 Google Chat 聊天室,方便他們探索及加入聊天室。
如要指定貴機構中可以探索及加入聊天室的使用者,請建立目標對象。目標對象是指可與特定使用者共用 Chat 聊天室的一群使用者 (例如特定部門或整個機構),以提升聊天室的認識和共用能力。此外,目標對像功能可讓您管理及自訂聊天室成員資格,而不必邀請個別使用者加入聊天室。詳情請參閱「關於目標對象」。
您只能將已命名的聊天室設為可供目標對象搜尋。您無法與目標對象共用其他聊天室類型,例如即時訊息或群組對話。
先備知識
- 可存取 Google Chat 的 Google Workspace 帳戶。您的帳戶必須具備 Google Workspace 機構的超級管理員角色。
- 開放在 Chat 中存取的目標對象。如要建立目標對象,請參閱「建立目標對象」一文。如要將現有目標對象提供給 Chat 聊天室,請參閱「設定 Chat 的聊天室存取權」。
取得目標對象 ID
如要取得目標對象的 ID,請按照下列步驟操作:
在 Google 管理控制台中,依序前往「Menu」(選單) >「Directory」(目錄) >「Target Audience」(目標對象)。
在「Target audiences」(目標對象) 表格中,按一下目標對象的「Name」(名稱) 欄位。
在網頁網址中找到目標對象 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 建立或更新聊天室,請參閱下列指南: