以 Google Workspace 管理員身分管理 Google Chat 聊天室

本頁面提供總覽資訊，說明 Google Workspace 管理員如何使用 Google Chat API，管理機構的 Google Chat 聊天室。

如要管理 Google 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 啟用管理員權限。

管理使用者的聊天室成員資格

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 擷取使用者設定檔，然後篩選出外部網域或機構的成員。詳情請參閱「Google Chat 如何識別使用者」。

稽核及管理聊天室

Google Workspace 管理員可透過下列情境，使用 Chat API 稽核及管理機構中的即時通訊空間。

找出並刪除閒置聊天室

未使用的 Chat 聊天室可能會佔用寶貴的儲存空間，並在使用者介面中造成混亂。管理員可以透過 spaces.search() 找出閒置的聊天室，然後透過 spaces.delete() 刪除這些聊天室。如需進一步的指引和程式碼範例，請參閱「尋找及刪除閒置的 Google Chat 聊天室」。

稽核機構中的聊天室

管理員可以使用 spaces.search()， 擷取機構中的所有空間清單，以及每個空間的設定和中繼資料詳細資訊，例如建立日期、 上次活動日期、成員人數、記錄設定狀態，以及邀請外部訪客的權限。

根據搜尋條件匯出空間清單

管理員可以使用 spaces.search()，根據 query 中指定的條件擷取空間清單，然後將結果匯出為 CSV 檔案進行分析。

根據搜尋條件尋找聊天室成員

管理員可以使用 spaces.members.list()，擷取機構中任何聊天室的成員清單，並根據特定條件分析結果。

查看聊天室管理員

管理員可以使用 spaces.members.list()，擷取已篩選 MembershipState=ROLE_MANAGER 的聊天室成員清單。

如要找出貴機構中所有聊天室的管理員，請使用 spaces.search() 列出所有管理員。然後針對清單中的每個空間，使用 spaces.members.list 擷取管理員。