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)

このメッセージ部分のヘッダーのリスト。メッセージ ペイロード全体を表すトップレベルのメッセージ部分には、ToFromSubject などの標準の 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

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

trash

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

untrash

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