本節說明 Google Chat 應用程式如何進行通話 Chat API,這個 API 可讓 Chat 擴充應用程式執行以下動作: 建立聊天室、新增使用者至聊天室,並在不提示訊息的情況下張貼訊息 Chat 應用程式互動事件:
驗證
如要以非同步方式呼叫 Chat API,必須進行驗證。每項 Chat API 方法需要 使用者驗證 (以便執行操作或存取 代表使用者的資料) 或 應用程式驗證 (以 Chat 應用程式的形式執行動作或存取資料)。只有部分通知 方法均支援使用者驗證和應用程式驗證。
如要進一步瞭解 Chat 的驗證,請參閱 驗證總覽。
API 資源與方法
REST 資源和方法授予 Chat 非同步存取權 聊天室、聊天室成員、訊息、訊息回應和訊息附件。
- 聊天室
聊天室是使用者和應用程式對話及分享檔案的空間。有 是幾種聊天室類型即時訊息 (DM) 適用於 1:1 對話 在單一使用者之間或使用者與 Chat 應用程式之間來回切換Google 網路論壇 聊天是指三位以上使用者之間的對話,以及 Chat 擴充應用程式。已命名的聊天室是使用者傳送資料的永久性位置 輕鬆收發訊息、分享檔案及協同合作。
spaces
項資源 代表空格聊天室支援下列方法:
- 成員
成員:包括已加入或已加入的使用者和 Chat 擴充應用程式 受邀加入聊天室。
spaces.members
項資源 代表成員成員支援下列方法:
- 訊息
訊息包括 文字 和 資訊卡 在聊天室中發布的通訊內容您可以在訊息中附加檔案。 使用者可以在訊息中加入表情符號來回應訊息。
spaces.messages
項資源 代表訊息「訊息」支援下列方法:
- 反應
回應代表使用者回應訊息時使用的表情符號,例如 👍?、🚲?, 角落
spaces.messages.reactions
項資源 每個元素都代表一個回應回應支援下列方法:
- 媒體與附件
「Media」代表上傳到 Google Chat 的檔案,例如圖片、影片 文件。
media
項資源 代表訊息附加的媒體。附件是附加在郵件中的媒體 (檔案) 例項。
spaces.messages.attachments
項資源 代表一個附件附件包括媒體 附加在訊息中的中繼資料媒體和附件支援下列方法:
- 聊天室活動
聊天室事件代表聊天室或聊天室的變更 子項資源,包括其成員、訊息和回應。
spaces.spaceEvent
資源 代表聊天室事件聊天室事件支援下列方法:
- 使用者讀取狀態
使用者讀取狀態是單例模式資源,代表 指定使用者在 Google Chat 聊天室或訊息中上次讀取的訊息 。
users.spaces
資源 代表使用者在聊天室中的讀取狀態。users.spaces.threads
資源 代表使用者在訊息串中的讀取狀態。使用者讀取狀態支援下列方法: