Google Chat API 包含 REST 資源和 Chat 事件。
REST 資源會授予 Chat 訊息、聊天室和附件的存取權。
Chat REST 資源的常見用途包括下列工作:
- 建立、刪除及更新訊息。
- 列出在聊天室中對話的使用者和即時通訊應用程式。
- 列出 Chat 應用程式已新增的所有聊天室。
即時通訊事件可讓 Chat 應用程式接收及回應 Chat API 傳送的事件,例如新增至聊天室或由使用者傳送訊息。即時通訊應用程式會收到 JSON 格式的酬載相關資訊 (例如應用程式加入哪個空間),Chat 應用程式會透過此管道處理及傳送 JSON 格式的回應,例如歡迎訊息。
下列是 Google Chat API 中的常用詞彙:
- 訊息
- 即時通訊訊息,包括寄件者、聊天室、文字、附件和資訊卡。訊息以訊息資源表示。
- 資訊卡
- 這個 UI 元素可包含互動式和靜態小工具,例如文字、圖片和按鈕。卡片是由卡片資源表示。
- 空格
- 兩個以上使用者之間的對話,或使用者和 Chat 應用程式之間的 1:1 訊息。聊天室以空間資源表示。
- 事件
- 事件代表 Chat 應用程式可回應的動作,例如接收訊息、點選資訊卡,以及在聊天室中新增或移除訊息。事件以事件類型表示。
- 成員資格
- 使用者加入聊天室的情形,包括他們是否加入或有待回覆的邀請。成員資格以成員資源表示。
後續步驟
如要瞭解如何使用 Chat API 進行驗證,請參閱授權及驗證即時通訊應用程式和 API 要求。
如要瞭解如何開始使用 Chat REST 資源,請參閱使用 REST API。
如要瞭解如何開始使用 Chat 事件,請參閱接收及回覆 Google Chat 活動。
如要瞭解如何設定及執行簡易的 Chat 應用程式,請參閱使用 Google Cloud Functions 建構 Google Chat 應用程式。