Method: users.messages.import

Nhập một thư chỉ 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 thư tiêu chuẩn tương tự như khi nhận qua SMTP. Phương thức này không thực hiện quy trình kiểm tra SPF, nên có thể không hoạt động đối với một số thư rác, chẳng hạn như thư rác cố gắng thực hiện hành vi giả mạo miền. Phương thức này không gửi thông báo. Xin lưu ý rằng kích thước tối đa của thư là 150 MB.

Yêu cầu HTTP

  • URI tải lên, cho các yêu cầu tải nội dung đa phương tiện lên:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import
  • URI siêu dữ liệu, cho các yêu cầu chỉ có siêu dữ liệu:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
userId

string

Địa chỉ email của người dùng. Bạn có thể dùng giá trị đặc biệt me để cho biết người dùng đã xác thực.

Tham số truy vấn

Thông số
internalDateSource

enum (InternalDateSource)

Nguồn cho ngày nội bộ của thư trong Gmail.
neverMarkSpam

boolean

Bỏ qua quyết định của trình phân loại thư rác của Gmail và không bao giờ đánh dấu email này là THƯ RÁC trong hộp thư.
processForCalendar

boolean

Xử lý lời mời trên lịch trong email và thêm mọi cuộc họp đã trích xuất vào Lịch Google của người dùng này.
deleted

boolean

Đánh dấu email là đã bị xoá vĩnh viễn (không phải THÙNG RÁC) và chỉ quản trị viên Vault mới có thể xem email đó trong Google Vault. Chỉ dùng cho tài khoản Google Workspace.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Message.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Message.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.