Method: users.messages.import

將郵件匯入這個使用者的信箱，並進行標準電子郵件傳送掃描和分類，與透過 SMTP 接收郵件類似。這個方法不會執行 SPF 檢查，因此可能無法處理部分垃圾郵件，例如嘗試進行網域偽造的郵件。這個方法不會傳送訊息，請注意，郵件大小上限為 150 MB。

HTTP 要求

  • 上傳 URI，適用於媒體上傳要求：
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • 中繼資料 URI (僅限中繼資料要求)：
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

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

路徑參數

參數
userId

string

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

查詢參數

參數
internalDateSource

enum (InternalDateSource)

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

boolean

忽略 Gmail 垃圾郵件分類器的判斷結果，且絕不會在信箱中將這封電子郵件標示為垃圾郵件。
processForCalendar

boolean

處理電子郵件中的日曆邀請，並將所有擷取的會議新增至這位使用者的 Google 日曆。
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

詳情請參閱OAuth 2.0 Overview。