Method: users.messages.import
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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. Phương thức này không thực hiện việc kiểm tra SPF, vì vậy, phương thức này có thể không hoạt động đối với một số thư rác, chẳng hạn như những thư cố gắng giả mạo miền. Phương thức này không gửi thông báo.
Yêu cầu HTTP
- URI tải lên, dành cho 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/import
- URI siêu dữ liệu, dành cho các yêu cầu chỉ 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ể sử dụng giá trị đặc biệt me để cho biết người dùng đã được 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 công cụ 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 cho người dùng này.
|
deleted |
boolean
Đánh dấu email là đã xoá vĩnh viễn (không phải là THÙNG RÁC) và chỉ người quản trị Vault mới thấy 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 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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: users.messages.import\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nImports a message into only this user's mailbox, with standard email delivery scanning and classification similar to receiving via SMTP. This method doesn't perform SPF checks, so it might not work for some spam messages, such as those attempting to perform domain spoofing. This method does not send a message.\n\n### HTTP request\n\n- Upload URI, for media upload requests: \n `POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages/import`\n- Metadata URI, for metadata-only requests: \n `POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/import`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-----------------------------------------------------------------------------------------------------------|\n| `userId` | `string` The user's email address. The special value `me` can be used to indicate the authenticated user. |\n\n### Query parameters\n\n| Parameters ||\n|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `internalDateSource` | `enum (`[InternalDateSource](/workspace/gmail/api/reference/rest/v1/InternalDateSource)`)` Source for Gmail's internal date of the message. |\n| `neverMarkSpam` | `boolean` Ignore the Gmail spam classifier decision and never mark this email as SPAM in the mailbox. |\n| `processForCalendar` | `boolean` Process calendar invites in the email and add any extracted meetings to the Google Calendar for this user. |\n| `deleted` | `boolean` Mark the email as permanently deleted (not TRASH) and only visible in [Google Vault](http://support.google.com/vault/) to a Vault administrator. Only used for Google Workspace accounts. |\n\n### Request body\n\nThe request body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n### Response body\n\nIf successful, the response body contains an instance of [Message](/workspace/gmail/api/reference/rest/v1/users.messages#Message).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://mail.google.com/`\n- `\n https://www.googleapis.com/auth/gmail.modify`\n- `\n https://www.googleapis.com/auth/gmail.insert`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]