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)

内部メッセージ作成タイムスタンプ(エポックミリ秒)。受信トレイでの順序を決定するものです。通常の 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 メッセージのパート。これは、コンテナ MIME メッセージのパートにのみ適用されます(例: multipart/*)。コンテナ以外の MIME メッセージのパートタイプ(text/plain など)の場合、このフィールドは空です。詳細については、RFC 1521 をご覧ください。

JSON 表現
{
  "name": string,
  "value": string
}
フィールド
name

string

: 区切り記号の前にあるヘッダーの名前。例: To

value

string

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

Methods

batchDelete

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

batchModify

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

delete

指定したメッセージを直ちに完全に削除します。

get

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

import

標準のメール配信スキャンと SMTP による受信と同様の分類を使用して、このユーザーのメールボックスにのみメールをインポートします。

insert

IMAP APPEND と同様に、ユーザーのメールボックスにのみメールを直接挿入し、ほとんどのスキャンと分類を回避します。

list

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

modify

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

send

指定したメールを、ToCcBcc ヘッダーの受信者に送信します。

trash

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

untrash

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