Method: spaces.findDirectMessage

傳回指定使用者的現有即時訊息。如果找不到即時訊息聊天室，系統會傳回 404 NOT_FOUND 錯誤。如需範例，請參閱尋找即時訊息。

使用者驗證功能會傳回指定使用者和已驗證使用者之間的即時訊息空間。

使用應用程式驗證功能，傳回指定使用者與呼叫 Chat 應用程式之間的即時訊息空間。

必須完成使用者驗證或應用程式驗證。

HTTP 要求

GET https://chat.googleapis.com/v1/spaces:findDirectMessage

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
name

string

必要欄位。要接收即時訊息的使用者資源名稱。

格式：users/{user}，其中 {user} 為 People API 中 person 的 id，或在 Directory API 中代表使用者的 id。舉例來說，如果 People API 設定檔 ID 為 123456789，您就可以使用 users/123456789 做為 name，找出與該使用者的即時訊息。以使用者身分進行驗證時，您可以使用該電子郵件地址做為 {user} 的別名。舉例來說，users/example@gmail.com 中的 example@gmail.com 是 Google Chat 使用者的電子郵件地址。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體會包含 Space 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.bot

詳情請參閱授權指南。