本頁面概述 Google Workspace 管理員如何使用 Google Chat API 管理貴機構的 Google Chat 聊天室。
如要管理 Chat 聊天室，Google Workspace 管理員可以使用 Google 管理控制台中的聊天室管理工具，或呼叫 Google Chat API。管理員可以使用 Chat API 建立 Google Chat 應用程式，以便大規模管理聊天室，並自動執行常見或可重複執行的工作。
管理員可透過 Chat API 執行的操作
管理員可以根據指派的管理員角色執行管理工作。
身為 Google Workspace 管理員，您可以使用 Chat API 執行多項管理工作，例如：
如何以 Google Workspace 管理員身分進行驗證和授權
使用 Chat API 執行管理工作時，管理員可以透過叫用管理員權限或為應用程式服務帳戶設定全網域委派權限，驗證及授權要求。
下表說明管理員在使用 Chat API 時可用來驗證的方式。
| 使用者驗證 | 呼叫 API 方法的對象 | 使用者在 Chat 中看到的內容 |
|---|---|---|
| 管理員權限 | 已設定 useAdminAccess=true 的管理員 |
「機構管理員執行了 [某項動作]。」 例如：「機構管理員已將 Kiran B 變更為聊天室管理員。」 不會識別管理員使用者的名稱或使用者 ID，也不會識別 Chat 應用程式的名稱。 |
| 全網域委派 | 服務帳戶代表使用者 |
「[使用者] 透過 [應用程式名稱] 執行 [動作]。」 例如：「Sasha T 將聊天室重新命名為『Release Project Discussion』」。 系統會將服務冒用身分的使用者視為執行動作的使用者。 |
使用貴機構的 Chat API
本節的範例說明管理員如何在管理機構的聊天室和成員時，使用管理員權限使用 Chat API。
下列 Chat API 方法會透過 useAdminAccess=true 啟用管理員權限。
spaces.delete()spaces.get()spaces.patch()spaces.search()spaces.members.create()spaces.members.delete()spaces.members.get()spaces.members.list()spaces.members.patch()
管理使用者的聊天室成員資格
以下是 Google Workspace 管理員可以透過 Chat API 管理機構內使用者的聊天室成員資格的方式。
將使用者新增至聊天室
管理員可以使用 spaces.members.create()，將使用者新增至機構中的任何聊天室。
搭配使用 spaces.search() 後，管理員就能根據使用者的搜尋查詢，將使用者加入一組指定的聊天室。這項功能可在機構新員工上線時派上用場，讓管理員自動執行例行程序。
尋找使用者並將其從聊天室中移除
管理員可以使用 spaces.members.get()，判斷使用者 (機構內部或外部) 是否為機構中的任何聊天室成員。
管理員可以搭配使用 spaces.search()，找出使用者所屬的所有聊天室，然後透過 spaces.members.delete() 將使用者從聊天室中移除。當員工在機構內部轉換團隊，或離職員工離開機構時，這項功能就很實用，因為管理員可以自動執行例行程序。
將使用者升級為聊天室管理員
管理員可以使用 spaces.members.patch()，將聊天室成員從 ROLE_MEMBER 升級為 ROLE_MANAGER。管理員也可以使用 spaces.members.patch() 將成員從 ROLE_MANAGER 移至 ROLE_MEMBER。
管理員可以搭配使用 spaces.search()，找出沒有管理員的聊天室，然後使用 spaces.members.patch() 將現有成員升級為 ROLE_MANAGER。
尋找聊天室的外部成員
使用 spaces.members.list()，管理員可以擷取聊天室成員清單、從機構的 People API 或 Directory API 擷取使用者個人資料，然後篩選外部網域或機構成員的結果。詳情請參閱「Chat 如何識別使用者」。
稽核及管理聊天室
以下是 Google Workspace 管理員可以使用 Chat API 稽核及管理貴機構中空間的方式。
找出並刪除閒置的聊天室
未使用的 Chat 聊天室可能會佔用寶貴的儲存空間，並在使用者介面中造成雜亂。管理員可以使用 spaces.search() 找出閒置的聊天室，然後使用 spaces.delete() 刪除這些聊天室。如需進一步指引和程式碼範例，請參閱「尋找並刪除閒置的 Chat 聊天室」。
稽核機構中的聊天室
管理員可以使用 spaces.search() 擷取機構內所有空間的清單，並取得每個空間的詳細設定和中繼資料，例如建立日期、上次活動日期、成員人數、歷史記錄設定狀態，以及邀請外部訪客的功能。
根據搜尋條件匯出聊天室清單
管理員可以使用 spaces.search() 擷取符合 query 中指定條件的空間清單，並將結果匯出為 CSV 檔案進行分析。
根據搜尋條件尋找聊天室成員
管理員可以使用 spaces.members.list() 擷取機構中任何聊天室的成員清單，並根據特定條件分析結果。
尋找聊天室管理員
管理員可以使用 spaces.members.list()，針對篩選為 MembershipState=ROLE_MANAGER 的聊天室，擷取成員清單。
如要找出貴機構中所有聊天室的管理員，您可以使用 spaces.search() 列出所有管理員。接著，針對清單中的每個空間，使用 spaces.members.list 擷取管理員。