REST Resource: users.messages

リソース: Message

メール。

JSON 表現 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
フィールド
id

string

メッセージの不変の ID。
threadId

string

メッセージが属するスレッドの ID。スレッドにメッセージまたは下書きを追加するには、次の条件を満たしている必要があります。

  1. リクエストする threadId は、リクエストに指定する Message または Draft.Message で指定する必要があります。
  2. References ヘッダーと In-Reply-To ヘッダーは、RFC 2822 標準に準拠して設定する必要があります。
  3. Subject ヘッダーが一致している必要があります。
labelIds[]

string

このメッセージに適用されているラベルの ID のリスト。
snippet

string

メッセージ テキストの短い部分。
historyId

string

このメッセージを最後に変更した履歴レコードの ID。
internalDate

string (int64 format)

受信トレイ内の順序を決定する、内部メッセージの作成タイムスタンプ（エポック ms）。通常の SMTP 受信メールの場合、これは Google が最初にメッセージを受信した時刻を表します。これは Date ヘッダーよりも信頼性が高い値です。ただし、API で移行されたメールの場合は、Date ヘッダーに基づいてクライアントで構成できます。
payload

object (MessagePart)

メッセージ部分の解析済みメール構造。
sizeEstimate

integer

メッセージの推定サイズ（バイト単位）。
raw

string (bytes format)

RFC 2822 形式の base64url でエンコードされた文字列で、メール メッセージ全体。format=RAW パラメータが指定されている場合に、messages.get レスポンスと drafts.get レスポンスで返されます。

Base64 でエンコードされた文字列。

MessagePart

単一の MIME メッセージ パート。

JSON 表現 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
フィールド
partId

string

メッセージ部分の不変の ID。
mimeType

string

メッセージ部分の MIME タイプ。
filename

string

添付ファイルのファイル名。このメッセージ部分が添付ファイルを表す場合にのみ存在します。
headers[]

object (Header)

このメッセージ部分のヘッダーのリスト。メッセージ ペイロード全体を表すトップレベルのメッセージ部分には、To、From、Subject などの標準の RFC 2822 メールヘッダーが含まれます。
body

object (MessagePartBody)

このパートのメッセージ パート本文。コンテナ MIME メッセージ パートの場合は空になることがあります。
parts[]

object (MessagePart)

この部分の子 MIME メッセージ部分。これは、multipart/* などのコンテナ MIME メッセージ部分にのみ適用されます。コンテナ以外の MIME メッセージ部分のタイプ（text/plain など）の場合、このフィールドは空白です。詳細については、RFC 1521 をご覧ください。
JSON 表現 
{
  "name": string,
  "value": string
}
フィールド
name

string

: セパレータの前のヘッダー名。例: To
value

string

: 区切り文字の後のヘッダーの値。例: someuser@example.com

メソッド

batchDelete

 メッセージ ID で複数のメッセージを削除します。

batchModify

 指定したメッセージのラベルを変更します。

delete

 指定されたメッセージを即座に完全に削除します。

get

 指定したメッセージを取得します。

import

 メールをこのユーザーのメールボックスにのみインポートします。SMTP 経由での受信と同様に、標準のメール配信スキャンと分類が行われます。

insert

 IMAP APPEND と同様に、ほとんどのスキャンと分類をバイパスして、このユーザーのメールボックスにのみメッセージを直接挿入します。

list

 ユーザーのメールボックス内のメールを一覧表示します。

modify

 指定したメッセージのラベルを変更します。

send

 To、Cc、Bcc ヘッダーで指定されたメッセージを受信者に送信します。

trash

 指定されたメールをゴミ箱に移動します。

untrash

 指定したメールをゴミ箱から削除します。