本頁面由 Cloud Translation API 翻譯而成。

Google Chat API

您可以運用 Google Chat API 建構 Chat 擴充應用程式，藉此整合服務與 Google Chat，並管理 Chat 資源 (例如聊天室、成員和訊息)。

服務：chat.googleapis.com

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

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

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

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

方法
`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/*}` 個更新聊天室。
`search`	`GET /v1/spaces:search` 個開發人員預覽版：這是 Google Workspace 開發人員預覽版計畫的一環，可讓使用者搶先體驗特定功能。
`setup`	`POST /v1/spaces:setup` 個建立聊天室並將指定的使用者新增至聊天室。

方法
`create`	`POST /v1/{parent=spaces/*}/members` 個為通話對象、即時通訊應用程式、使用者或 Google 群組建立成員資格。
`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/}` 個更新成員資格。

方法
`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/}` 個更新訊息。

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

方法
`create`	`POST /v1/{parent=spaces//messages/}/reactions` 個建立回應並將回應新增至訊息。
`delete`	`DELETE /v1/{name=spaces//messages//reactions/*}` 個刪除對訊息的回應。
`list`	`GET /v1/{parent=spaces//messages/}/reactions` 個列出回應訊息的回應。

方法
`get`	`GET /v1/{name=spaces//spaceEvents/}` 個傳回 Google Chat 聊天室中的事件。
`list`	`GET /v1/{parent=spaces/*}/spaceEvents` 個列出 Google Chat 聊天室中的事件。

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

方法
`getThreadReadState`	`GET /v1/{name=users//spaces//threads/*/threadReadState}` 個傳回使用者在執行緒中讀取狀態的詳細資料，用於識別已讀和未讀郵件。