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。
  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)

此邮件部分的标头列表。顶层邮件部分表示整个邮件载荷，将包含标准的 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

 从“已删除邮件”中移除指定的邮件。