Google Chat API 總覽

本節說明 Google Chat 應用程式如何進行通話 Chat API，這個 API 可讓 Chat 擴充應用程式執行以下動作： 建立聊天室、新增使用者至聊天室，並在不提示訊息的情況下張貼訊息 Chat 應用程式互動事件：

驗證

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

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

API 資源與方法

REST 資源和方法授予 Chat 非同步存取權 聊天室、聊天室成員、訊息、訊息回應和訊息附件。

聊天室

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

spaces 項資源 代表空格

聊天室支援下列方法：

  • 建立聊天室。 方便使用者和應用程式對話及分享檔案。
  • 設定聊天室 建立聊天室，並在當中新增使用者和 Chat 應用程式 空白鍵。
  • 取得聊天室 即可查看聊天室的詳細資料。
  • 列出聊天室 即可查看可篩選的聊天室清單。
  • 更新聊天室 變更空間的屬性，例如使用者看到的顯示名稱 說明及規範
  • 刪除聊天室 並設為執行過程
  • 尋找即時訊息 (DM) 即可傳回兩位使用者之間的即時訊息，或是使用者和通話之間的即時訊息 Chat 擴充應用程式。
成員

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

spaces.members 項資源 代表成員

成員支援下列方法：

訊息

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

spaces.messages 項資源 代表訊息

「訊息」支援下列方法：

反應

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

spaces.messages.reactions 項資源 每個元素都代表一個回應

回應支援下列方法：

媒體與附件

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

media 項資源 代表訊息附加的媒體。

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

spaces.messages.attachments 項資源 代表一個附件附件包括媒體 附加在訊息中的中繼資料

媒體和附件支援下列方法：

聊天室活動

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

spaces.spaceEvent 資源 代表聊天室事件

聊天室事件支援下列方法：

使用者讀取狀態

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

users.spaces 資源 代表使用者在聊天室中的讀取狀態。

users.spaces.threads 資源 代表使用者在訊息串中的讀取狀態。

使用者讀取狀態支援下列方法：