Google Chat API

您可以運用 Google Chat API 建構 Chat 專用應用程式,藉此將服務與 Google Chat 整合,並管理聊天室、成員和訊息等 Chat 資源。

服務:chat.googleapis.com

如要呼叫這項服務,建議您使用 Google 提供的用戶端程式庫。如果應用程式需要使用您自己的程式庫來呼叫這項服務,請在提出 API 要求時使用下列資訊。

探索文件

探索文件是一種機器可解讀的規格,用於說明和使用 REST API。此文件用於建構用戶端程式庫、IDE 外掛程式,以及與 Google API 互動的其他工具。一項服務可能會提供多個探索文件。這項服務提供下列探索文件:

服務端點

服務端點是指定 API 服務網路位址的基準網址。一項服務可能有多個服務端點。這項服務有以下服務端點,且下方的 URI 皆以此服務端點為基準:

  • https://chat.googleapis.com

REST 資源:v1.media

方法
download GET /v1/media/{resourceName=**}
下載媒體。
upload POST /v1/{parent=spaces/*}/attachments:upload
POST /upload/v1/{parent=spaces/*}/attachments:upload
上傳附件。

REST 資源:v1.spaces

方法
completeImport POST /v1/{name=spaces/*}:completeImport
完成指定聊天室的匯入程序,並向使用者顯示。
create POST /v1/spaces
建立已命名的聊天室。
delete DELETE /v1/{name=spaces/*}
刪除已命名的聊天室。
findDirectMessage GET /v1/spaces:findDirectMessage
傳回指定使用者的現有即時訊息。
get GET /v1/{name=spaces/*}
傳回聊天室的詳細資料。
list GET /v1/spaces
列出呼叫者所屬的聊天室。
patch PATCH /v1/{space.name=spaces/*}
更新聊天室。
setup POST /v1/spaces:setup
建立聊天室,並將指定使用者加入聊天室。

REST 資源:v1.spaces.members

方法
create POST /v1/{parent=spaces/*}/members
為呼叫應用程式建立使用者成員資格或應用程式成員資格。
delete DELETE /v1/{name=spaces/*/members/*}
刪除會員資格。
get GET /v1/{name=spaces/*/members/*}
傳回會員資格詳細資料。
list GET /v1/{parent=spaces/*}/members
列出聊天室中的成員。
patch PATCH /v1/{membership.name=spaces/*/members/*}
更新會員資格。

REST 資源:v1.spaces.messages

方法
create POST /v1/{parent=spaces/*}/messages
在 Google Chat 聊天室中建立訊息。
delete DELETE /v1/{name=spaces/*/messages/*}
刪除訊息。
get GET /v1/{name=spaces/*/messages/*}
傳回訊息的詳細資料。
list GET /v1/{parent=spaces/*}/messages
列出來電者所屬聊天室中的訊息,包括已封鎖的成員和聊天室的訊息。
patch PATCH /v1/{message.name=spaces/*/messages/*}
更新訊息。
update PUT /v1/{message.name=spaces/*/messages/*}
更新訊息。

REST 資源:v1.spaces.messages.attachments

方法
get GET /v1/{name=spaces/*/messages/*/attachments/*}
取得訊息附件的中繼資料。

REST 資源:v1.spaces.messages.reactions

方法
create POST /v1/{parent=spaces/*/messages/*}/reactions
建立回應並加入訊息中。
delete DELETE /v1/{name=spaces/*/messages/*/reactions/*}
刪除訊息的回應。
list GET /v1/{parent=spaces/*/messages/*}/reactions
列出訊息的回應。

REST 資源:v1.spaces.spaceEvents

方法
get GET /v1/{name=spaces/*/spaceEvents/*}
傳回 SpaceEvent
list GET /v1/{parent=spaces/*}/spaceEvents
列出呼叫者所屬聊天室中的 SpaceEvent

REST 資源:v1.users.spaces

方法
getSpaceReadState GET /v1/{name=users/*/spaces/*/spaceReadState}
傳回使用者在聊天室中讀取狀態的詳細資料,用於識別已讀/未讀訊息。
updateSpaceReadState PATCH /v1/{spaceReadState.name=users/*/spaces/*/spaceReadState}
在聊天室中更新使用者的讀取狀態,用來識別已讀/未讀訊息。

REST 資源:v1.users.spaces.threads

方法
getThreadReadState GET /v1/{name=users/*/spaces/*/threads/*/threadReadState}
傳回使用者在討論串中讀取狀態的詳細資料,用於識別已讀/未讀訊息。