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

メールを完全に削除済み（ゴミ箱ではない）としてマークし、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 をご覧ください。