REST Resource: users.messages

Tài nguyên: Thông báo

Một email.

Biểu diễn dưới dạng JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Trường
id

string

Mã không thể thay đổi của thư.
threadId

string

Mã nhận dạng của chuỗi tin nhắn mà thư thuộc về. Để thêm tin nhắn hoặc thư nháp vào một chuỗi thư, bạn phải đáp ứng các tiêu chí sau:

  1. Bạn phải chỉ định threadId được yêu cầu trên Message hoặc Draft.Message mà bạn cung cấp cùng với yêu cầu.
  2. Bạn phải đặt tiêu đề References và In-Reply-To tuân thủ tiêu chuẩn RFC 2822.
  3. Các tiêu đề Subject phải khớp.
labelIds[]

string

Danh sách mã nhận dạng của các nhãn được áp dụng cho thư này.
snippet

string

Một phần ngắn của văn bản tin nhắn.
historyId

string

Mã của bản ghi nhật ký gần đây nhất đã sửa đổi thông báo này.
internalDate

string (int64 format)

Dấu thời gian tạo thư nội bộ (ms theo kỷ nguyên), xác định thứ tự trong hộp thư đến. Đối với email thông thường được nhận qua SMTP, giá trị này thể hiện thời điểm Google chấp nhận thư ban đầu. Giá trị này đáng tin cậy hơn tiêu đề Date. Tuy nhiên, đối với thư được di chuyển bằng API, ứng dụng có thể định cấu hình thư dựa trên tiêu đề Date.
payload

object (MessagePart)

Cấu trúc email đã phân tích cú pháp trong các phần của thư.
sizeEstimate

integer

Kích thước ước tính của thư tính bằng byte.
raw

string (bytes format)

Toàn bộ thư email ở định dạng RFC 2822 và được mã hoá base64url. Được trả về trong các phản hồi messages.get và drafts.get khi bạn cung cấp tham số format=RAW.

Chuỗi được mã hoá base64.

MessagePart

Một phần thư MIME.

Biểu diễn dưới dạng JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Trường
partId

string

Mã không thể thay đổi của phần thông báo.
mimeType

string

Loại MIME của phần thông báo.
filename

string

Tên tệp của tệp đính kèm. Chỉ xuất hiện nếu phần thông báo này đại diện cho một tệp đính kèm.
headers[]

object (Header)

Danh sách tiêu đề trên phần thư này. Đối với phần thư cấp cao nhất, đại diện cho toàn bộ tải trọng thư, phần này sẽ chứa các tiêu đề email RFC 2822 tiêu chuẩn như To, From và Subject.
body

object (MessagePartBody)

Nội dung phần thư cho phần này. Phần này có thể trống đối với các phần thư MIME của vùng chứa.
parts[]

object (MessagePart)

Các phần tin nhắn MIME con của phần này. Điều này chỉ áp dụng cho các phần tin nhắn MIME của vùng chứa, ví dụ: multipart/*. Đối với các loại phần tin nhắn MIME không phải vùng chứa, chẳng hạn như text/plain, trường này sẽ trống. Để biết thêm thông tin, hãy xem RFC 1521.
Biểu diễn dưới dạng JSON 
{
  "name": string,
  "value": string
}
Trường
name

string

Tên của tiêu đề trước dấu phân cách :. Ví dụ: To.
value

string

Giá trị của tiêu đề sau dấu phân cách :. Ví dụ: someuser@example.com.

Phương thức

batchDelete

 Xoá nhiều thư theo mã thư.

batchModify

 Sửa đổi nhãn trên các thư được chỉ định.

delete

 Xoá vĩnh viễn và ngay lập tức thư đã chỉ định.

get

 Nhận thông báo đã chỉ định.

import

 Chỉ nhập thư vào hộp thư của người dùng này, với tính năng quét và phân loại email gửi tiêu chuẩn tương tự như khi nhận qua SMTP.

insert

 Trực tiếp chèn một thư vào hộp thư của người dùng này tương tự như IMAP APPEND, bỏ qua hầu hết các hoạt động quét và phân loại.

list

 Liệt kê các thư trong hộp thư của người dùng.

modify

 Sửa đổi nhãn trên thư đã chỉ định.

send

 Gửi thông báo đã chỉ định đến người nhận trong tiêu đề To, Cc và Bcc.

trash

 Di chuyển thư đã chỉ định vào thùng rác.

untrash

 Xoá thư đã chỉ định khỏi thùng rác.