Method: users.threads.get

• HTTP 要求
• 路徑參數
• 查詢參數
• 要求主體
• 回應主體
• 授權範圍
• 格式
• 試試看！

取得指定的執行緒。

HTTP 要求

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

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

路徑參數

參數
userId	string 使用者的電子郵件地址。特殊值 me 可用於表示已驗證使用者。
id	string 要擷取的執行緒 ID。

查詢參數

參數
format	enum (Format) 訊息的傳回格式。
metadataHeaders[]	string 如果指定且格式為 METADATA，請僅納入指定的標頭。

要求主體

要求主體必須為空白。

回應主體

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

授權範圍

需要下列其中一種 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

詳情請參閱授權指南。

形式

列舉
full	傳回包含 payload 欄位中剖析的主體內容的完整電子郵件資料；系統不會使用 raw 欄位。透過 gmail.metadata 範圍存取 API 時無法使用此格式。
metadata	僅傳回電子郵件 ID、標籤和電子郵件標頭。
minimal	僅傳回電子郵件 ID 和標籤，不會傳回電子郵件標頭、內文或酬載。