本頁面說明如何使用 Google Chat API 與 Google Workspace 機構中的特定使用者共用 Google Chat 聊天室，方便他們探索及加入聊天室。
如要指定貴機構中可探索及加入聊天室的使用者，請建立目標對象。目標對象是一群使用者 (例如特定部門或整個機構)，您可以與他們分享 Chat 聊天室，藉此提高聊天室的知名度和分享率。您也可以透過目標對象管理及自訂聊天室會員資格，而不需要邀請個別使用者加入聊天室。詳情請參閱「關於指定目標對象」。
您只能將已命名的聊天室設為可供目標對象搜尋。您無法將其他聊天室類型 (例如即時訊息或群組對話) 分享給目標對象。
必要條件
- 具備 Google Chat 存取權的 Google Workspace 企業或進階版帳戶。您的帳戶必須具備 Google Workspace 機構的超級管理員角色。
- 可在 Chat 中存取的目標對象。如要建立目標對象，請參閱「建立目標對象」。如要讓現有目標對象可使用 Chat 聊天室，請參閱「設定 Chat 聊天室存取權」。
- 您必須呼叫 Google Chat API，並提供使用者驗證功能。
取得目標對象 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 建立或更新聊天室，請參閱下列指南：