Tài liệu này giải thích cách tạo, cập nhật và gửi email nháp bằng Gmail API.
Thư nháp là những thư chưa gửi và được áp dụng nhãn hệ thống DRAFT.
Bạn không thể chỉnh sửa nội dung trong bản nháp sau khi tạo, nhưng có thể thay thế nội dung đó. Theo nghĩa này, tài nguyên drafts là một vùng chứa cung cấp mã nhận dạng ổn định vì mã nhận dạng thông báo cơ bản sẽ thay đổi mỗi khi thông báo được thay thế.
Tài nguyên messages trong bản nháp có hành vi tương tự như các thông báo khác, ngoại trừ những điểm khác biệt sau:
- Thư nháp không được có nhãn nào khác ngoài nhãn hệ thống
DRAFT. - Khi bản nháp được gửi, bản nháp sẽ tự động bị xoá và một thư mới có mã nhận dạng mới sẽ được tạo bằng nhãn hệ thống
SENT. Thông báo này được trả về trong phản hồi phương thứcdrafts.send.
Tạo bản nháp
Ứng dụng của bạn có thể tạo bản nháp bằng phương thức drafts.create. Cách tạo bản nháp:
- Tạo một thư MIME tuân thủ RFC 2822.
- Chuyển đổi thông báo thành một chuỗi được mã hoá base64URL.
- Gọi phương thức
drafts.create, đặt giá trị của trườngmessages.rawthành chuỗi được mã hoá.
Các mẫu mã sau đây minh hoạ quy trình này:
Java
Python
cURL
curl --request POST \
'https://gmail.googleapis.com/gmail/v1/users/me/drafts' \
--header 'Authorization: Bearer ACCESS_TOKEN" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"message":{"raw":"MESSAGE"}}'
Thay thế nội dung sau:
- ACCESS_TOKEN: mã truy cập cấp quyền truy cập vào API.
- MESSAGE: thông báo MIME được định dạng RFC 2822, được mã hoá dưới dạng base64URL.
Cập nhật bản nháp
Tương tự như việc tạo bản nháp, để cập nhật bản nháp, bạn phải cung cấp một tài nguyên drafts trong nội dung yêu cầu của mình với trường messages.raw được đặt thành một chuỗi được mã hoá base64URL chứa thông báo MIME. Vì không thể cập nhật thư nên thư có trong thư nháp sẽ bị xoá và thay thế bằng thư MIME mới được cung cấp trong yêu cầu cập nhật.
Bạn có thể truy xuất thông báo MIME hiện tại có trong bản nháp bằng cách gọi phương thức drafts.get bằng tham số truy vấn format=raw.
Để biết thêm thông tin, hãy xem phương thức drafts.update.
Gửi bản nháp
Khi gửi bản nháp, bạn có thể gửi nguyên trạng hoặc cung cấp thông tin cập nhật trong yêu cầu gửi.
Để cập nhật bản nháp khi gửi, hãy cung cấp tài nguyên drafts trong nội dung yêu cầu của phương thức drafts.send. Trong tài nguyên drafts, bạn phải chỉ định bản nháp id của bản nháp sẽ được gửi và đặt trường messages.raw thành thông báo MIME mới được mã hoá dưới dạng chuỗi base64URL.
Để biết thông tin về cách gửi thư trong Gmail, hãy xem bài viết Gửi thư.