Google Chat API 總覽

本節說明 Google Chat 應用程式透過何種方式 Chat API，這個 API 可讓 Chat 擴充應用程式執行以下動作： 建立聊天室、將使用者新增至聊天室，以及張貼訊息。

驗證

呼叫 Chat API 需要驗證。每項 Chat API 方法需要 使用者驗證 (以便執行操作或存取 代表使用者的資料) 或 應用程式驗證 (以 Chat 應用程式的形式執行動作或存取資料)。只有部分通知 方法均支援使用者驗證和應用程式驗證。

如要進一步瞭解 Chat 的驗證，請參閱 驗證總覽。

用戶端程式庫

對大多數開發人員呼叫 Google Chat API 的建議做法 包含正式支援的 Cloud 用戶端程式庫 。

如果您是透過 Google Apps Script 編寫程式碼，請使用 進階 Chat 服務 無須安裝用戶端程式庫

Google Chat API 概念

gRPC 服務或 REST 資源與方法 授予 Chat 聊天室、聊天室成員、訊息和訊息的存取權 回應、訊息附件、聊天室事件和使用者讀取狀態。

聊天室

聊天室是使用者和應用程式對話及分享檔案的空間。有 是幾種聊天室類型即時訊息 (DM) 適用於 1:1 對話 在單一使用者之間或使用者與 Chat 應用程式之間來回切換Google 網路論壇 聊天是指三位以上使用者之間的對話，以及 Chat 擴充應用程式。已命名的聊天室是使用者傳送資料的永久性位置 輕鬆收發訊息、分享檔案及協同合作。

資源參照：

如需使用範例，請參閱：

成員

成員：包括已加入或已加入的使用者和 Chat 擴充應用程式 受邀加入聊天室。

資源參照：

如需使用範例，請參閱：

訊息

訊息包括 文字 和 資訊卡 在聊天室中發布的通訊內容您可以在訊息中附加檔案。 使用者可以在訊息中加入表情符號來回應訊息。

資源參照：

如需使用範例，請參閱：

反應

回應代表使用者回應訊息時使用的表情符號，例如 👍?、🚲?, 角落

資源參照：

如需使用範例，請參閱：

媒體與附件

「Media」代表上傳到 Google Chat 的檔案，例如圖片、影片 文件。

媒體資源參考資料 (不適用於遠端程序呼叫)：

附件是附加在郵件中的媒體 (檔案) 例項。

資源參照：

如需使用範例，請參閱：

聊天室活動

聊天室事件代表聊天室或聊天室的變更 子項資源，包括其成員、訊息和回應。

資源參照：

如需使用範例，請參閱：

使用者讀取狀態

使用者讀取狀態是單例模式資源，代表 指定使用者在 Google Chat 聊天室或訊息中上次讀取的訊息 。

聊天室讀取狀態資源參照：

執行緒讀取狀態資源參考資料：

如需使用範例，請參閱：

除了呼叫 Chat API 之外，即時通訊應用程式還能：