Method: users.messages.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. Không gửi tin nhắn.

Yêu cầu HTTP

  • URI tải lên, đối với các yêu cầu tải nội dung nghe nhìn lên:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
  • URI siêu dữ liệu, đối với các yêu cầu chỉ siêu dữ liệu:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

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

Tham số đường dẫn

Các tham số
userId

string

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

Tham số truy vấn

Các tham số
internalDateSource

enum (InternalDateSource)

Nguồn cho ngày thư nội bộ trong Gmail.
deleted

boolean

Đánh dấu email là đã xóa vĩnh viễn (không phải TRASH) và chỉ hiển thị trong Google Vault đối với quản trị viên 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 phiên bản 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 Hướng dẫn uỷ quyền.