Method: users.messages.insert

直接將郵件插入此使用者的信箱 (類似於 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

string

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

查詢參數

參數
internalDateSource

enum (InternalDateSource)

郵件 Gmail 內部日期的來源。
deleted

boolean

將電子郵件標示為永久刪除 (而非「垃圾桶」)，並只向保管箱管理員顯示在 Google 保管箱中。僅適用於 Google Workspace 帳戶。

要求主體

要求主體包含 Message 的例項。

回應主體

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

授權範圍

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

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

詳情請參閱授權指南。