Method: users.messages.get

取得指定訊息。

HTTP 要求

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}

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

路徑參數

參數
userId

string

使用者的電子郵件地址。特殊值 me 可用於表示已驗證使用者。

id

string

要擷取的訊息 ID。這個 ID 通常是使用 messages.list 擷取。ID 也會在插入郵件 (messages.insert) 或匯入郵件 (messages.import) 時包含在結果中。

查詢參數

參數
format

enum (Format)

訊息的傳回格式。

metadataHeaders[]

string

如果指定且格式為 METADATA,請僅納入指定的標頭。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

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

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.metadata

詳情請參閱授權指南