直接將郵件插入這位使用者的信箱 (類似於 IMAP APPEND)，與大多數的掃描及分類機制略過。不會傳送訊息。
HTTP 要求
- 媒體上傳要求的 URI：
POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages - 中繼資料 URI (僅限中繼資料要求)：
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
userId |
使用者的電子郵件地址。特殊值 |
查詢參數
| 參數 | |
|---|---|
internalDateSource |
Gmail 郵件內部日期的來源。 |
deleted |
將電子郵件標示為已永久刪除 (而非 TRASH)，且只會在 Google 保管箱中顯示給保管箱管理員。僅適用於 Google Workspace 帳戶。 |
要求主體
要求主體包含 Message 的例項。
回應主體
如果成功，回應主體會包含 Message 的執行例項。
授權範圍
需要下列其中一種 OAuth 範圍：
https://mail.google.com/https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.insert
詳情請參閱授權指南。