本頁面由 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 皆以此服務端點為基準：

方法
`create`	`POST /v1/customEmojis` 開發人員預覽版：這是 Google Workspace 開發人員預覽版計畫的一環，這項計畫可讓使用者搶先體驗特定功能。建立自訂表情符號。
`delete`	`DELETE /v1/{name=customEmojis/}` 開發人員搶先體驗版：*可透過 Google Workspace 開發人員搶先體驗計畫取得，可提前使用特定功能。刪除自訂表情符號。
`get`	`GET /v1/{name=customEmojis/}` 開發人員搶先體驗版：*可透過 Google Workspace 開發人員搶先體驗計畫取得，可提前使用特定功能。傳回自訂表情符號的詳細資料。
`list`	`GET /v1/customEmojis` 開發人員搶先體驗版：可透過 Google Workspace 開發人員搶先體驗計畫取得，可提前使用特定功能。列出已驗證使用者可看見的自訂表情符號。

方法
`download`	`GET /v1/media/{resourceName=**}` 下載媒體。
`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` 為通話 Chat 應用程式、使用者或 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}` 更新使用者在聊天室內的已讀狀態，用於識別已讀和未讀訊息。

方法
`get`	`GET /v1/{name=users//spaces//spaceNotificationSetting}` 開發人員搶先體驗版：可透過 Google Workspace 開發人員搶先體驗計畫取得，可提前使用特定功能。取得聊天室通知狀態設定。
`patch`	`PATCH /v1/{spaceNotificationSetting.name=users//spaces//spaceNotificationSetting}` 開發人員預覽版：這是 Google Workspace 開發人員預覽版計畫的一環，這項計畫可讓使用者搶先體驗特定功能。更新聊天室通知狀態設定。

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