REST Resource: users.messages

Tài nguyên: Thư

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
}
Các trường
id

string

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

string

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

  1. threadId được yêu cầu phải được chỉ định trên Message hoặc Draft.Message mà bạn cung cấp cùng với yêu cầu của mình.
  2. Các tiêu đề References và In-Reply-To phải được đặt theo 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 nội dung tin nhắn.
historyId

string

Mã của bản ghi nhật ký gần đây nhất đã sửa đổi tin nhắn này.
internalDate

string (int64 format)

Dấu thời gian tạo thư nội bộ (mili giây bắt đầu của hệ thống), xác định thứ tự trong hộp thư đến. Đối với email nhận được SMTP thông thường, thông số này thể hiện thời gian Google chấp nhận thư ban đầu, đá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 được phân tích cú pháp trong các phần của thư.
sizeEstimate

integer

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

string (bytes format)

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

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

MessagePart

Một phần thông điệp MIME duy nhất.

Biểu diễn dưới dạng JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Các 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ỉ hiển thị nếu phần tin nhắn này đại diện cho tệp đính kèm.
headers[]

object (Header)

Danh sách tiêu đề của phần thư này. Đối với phần thư cấp cao nhất, đại diện cho toàn bộ phần tải thư, thư 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ông báo của phần này, có thể trống đối với các phần thông báo MIME vùng chứa.
parts[]

object (MessagePart)

Các phần của thông điệp MIME con trong phần này. Điều này chỉ áp dụng cho các phần của thông báo MIME vùng chứa, ví dụ: multipart/*. Đối với các loại phần thông báo MIME không chứa vùng chứa, chẳng hạn như text/plain, trường này để 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
}
Các 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ã nhận dạng thư.

batchModify

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

delete

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

get

 Nhận thông báo được 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 tiêu chuẩn tương tự như nhận qua SMTP.

insert

 Chèn trực tiếp thư vào chỉ 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 các nhãn trên thư được chỉ định.

send

 Gửi thư được 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.