REST Resource: users.messages

資源：訊息

電子郵件。

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. 您必須在要求的 Message 或 Draft.Message 上threadId指定所要求的<br>。
  2. 您必須按照 RFC 2822 標準設定 References 和 In-Reply-To 標頭。
  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 編碼的字串。

訊息部分

單一 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)

這個訊息部分的標題清單。針對代表整個訊息酬載的頂層訊息部分，其中包含標準 RFC 2822 電子郵件標頭 (例如 To、From 和 Subject)。
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。

方法

batchDelete

 依郵件 ID 刪除多封郵件。

batchModify

 修改指定郵件中的標籤。

delete

 立即永久刪除指定訊息。

get

 取得指定訊息。

import

 只將郵件匯入這位使用者的信箱，並以標準電子郵件傳送和分類方式執行，類似於透過 SMTP 接收的郵件。

insert

 直接將郵件插入這位使用者的信箱 (類似於 IMAP APPEND)，與大多數的掃描及分類機制略過。

list

 列出使用者信箱中的郵件。

modify

 修改指定郵件中的標籤。

send

 將指定訊息傳送給 To、Cc 和 Bcc 標頭中的收件者。

trash

 將指定的郵件移至垃圾桶。

untrash

 從垃圾桶移除指定郵件。