メールは、このユーザーのメールボックスにのみインポートされます。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 |
ユーザーのメールアドレスです。認証されたユーザーを示すには、特別な値 |
クエリ パラメータ
パラメータ | |
---|---|
internalDateSource |
Gmail のメッセージの内部日付のソース。 |
neverMarkSpam |
Gmail の迷惑メール分類システムの判断を無視し、受信トレイでこのメールを迷惑メールとしてマークしないでください。 |
processForCalendar |
メール内のカレンダーの招待状を処理し、抽出された会議をこのユーザーの Google カレンダーに追加します。 |
deleted |
メールを完全に削除済み(ゴミ箱ではない)としてマークし、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
詳しくは、認可ガイドをご覧ください。