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. 您在要求提供的 MessageDraft.Message 中必須指定要求的 threadId
  2. ReferencesIn-Reply-To 標頭必須符合 RFC 2822 標準。
  3. Subject 標頭必須相符。

labelIds[]

string

套用至這則訊息的標籤 ID 清單。

snippet

string

訊息文字的簡短部分,

historyId

string

修改這則訊息的最近一次記錄 ID。

internalDate

string (int64 format)

內部郵件建立時間戳記 (Epoch 毫秒),這會影響收件匣中的排序。對於一般 SMTP 接收的電子郵件,這是指 Google 最初接受郵件的時間,比 Date 標頭更可靠。然而,如果是遷移 API 的郵件,用戶端可根據 Date 標頭進行設定。

payload

object (MessagePart)

剖析郵件部分中的電子郵件結構。

sizeEstimate

integer

訊息的預估大小 (以位元組為單位)。

raw

string (bytes format)

採用 RFC 2822 格式和 Base64url 編碼字串的完整電子郵件。提供 format=RAW 參數時,在 messages.getdrafts.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)

此郵件部分的標頭清單。針對代表整個郵件酬載的頂層郵件部分,其中包含標準 RFC 2822 電子郵件標頭,例如 ToFromSubject

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

將指定郵件傳送給 ToCcBcc 標頭中的收件者。

trash

將指定郵件移至垃圾桶。

untrash

將指定郵件從垃圾桶中移除。