Method: users.messages.import

メールは、このユーザーのメールボックスにのみインポートされます。SMTP 経由での受信と同様に、標準のメール配信スキャンと分類が行われます。この方法では SPF チェックは行われないため、ドメインのなりすましを試みる迷惑メールなど、一部の迷惑メールでは機能しないことがあります。このメソッドはメッセージを送信しません。

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

詳しくは、認可ガイドをご覧ください。