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

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

パスパラメータ

パラメータ
userId

string

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

クエリ パラメータ

パラメータ
internalDateSource

enum (InternalDateSource)

Gmail 内部のメールの日付のソース。
deleted

boolean

メールを完全に削除（TRASH ではない）としてマークし、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

詳細については、承認ガイドをご覧ください。