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 管理者のみが Google Vault で表示できるようにします。Google Workspace アカウントでのみ使用されます。

リクエストの本文

リクエストの本文には Message のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には Message のインスタンスが含まれます。

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

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