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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userId

string

ユーザーのメールアドレス。特別な値 me を使用して、認証済みユーザーを示すことができます。

クエリ パラメータ

パラメータ
internalDateSource

enum (InternalDateSource)

Gmail のメッセージの内部日付のソース。
neverMarkSpam

boolean

Gmail の迷惑メール分類ツールの判定を無視し、このメールをメールボックスで迷惑メールとしてマークしない。
processForCalendar

boolean

メール内のカレンダーの招待状を処理し、抽出された会議をこのユーザーの Google カレンダーに追加します。
deleted

boolean

メールを完全に削除済み（ゴミ箱ではない）としてマークし、Google Vault でのみ Vault 管理者に表示されるようにします。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 をご覧ください。