Gmail API là một API RESTful có thể dùng để truy cập vào hộp thư Gmail và gửi thư. Đối với hầu hết các ứng dụng web, Gmail API là lựa chọn tốt nhất để truy cập vào dữ liệu Gmail của người dùng một cách được uỷ quyền và phù hợp với nhiều ứng dụng, chẳng hạn như:
- Chỉ đọc nội dung trích xuất, lập chỉ mục và sao lưu email
- Gửi tin nhắn tự động hoặc theo chương trình
- Di chuyển tài khoản email
- Sắp xếp email, bao gồm cả việc lọc và sắp xếp thư
- Tiêu chuẩn hoá chữ ký email trong một tổ chức
Sau đây là danh sách các thuật ngữ thường dùng trong Gmail API:
- Tin nhắn
- Một thư email chứa thông tin về người gửi, người nhận, tiêu đề và nội dung. Sau khi tạo, bạn không thể thay đổi nội dung của một thông báo. Thông báo được biểu thị bằng một tài nguyên thông báo.
- Luồng
- Một nhóm các tin nhắn có liên quan với nhau tạo thành một cuộc trò chuyện. Trong một ứng dụng email, chuỗi email được tạo khi một hoặc nhiều người nhận phản hồi một thư bằng thư của riêng họ.
- Nhãn
Một cơ chế để sắp xếp tin nhắn và chuỗi tin nhắn. Ví dụ: bạn có thể tạo và áp dụng nhãn "thuế" cho tất cả thư và chuỗi thư liên quan đến thuế của người dùng. Có hai loại nhãn:
- Nhãn hệ thống
- Nhãn do nội bộ tạo, chẳng hạn như
INBOX
,TRASH
hoặcSPAM
. Bạn không thể xoá hoặc sửa đổi các nhãn này. Tuy nhiên, bạn có thể áp dụng hoặc xoá một số nhãn hệ thống, chẳng hạn nhưINBOX
đối với thư và chuỗi thư. - Nhãn người dùng
- Nhãn do người dùng tạo. Người dùng hoặc ứng dụng có thể xoá hoặc sửa đổi các nhãn này. Nhãn người dùng được biểu thị bằng một tài nguyên nhãn.
- Draft
Một tin nhắn chưa gửi. Bạn có thể thay thế một thông báo trong bản nháp. Khi bạn gửi thư nháp, thư nháp sẽ tự động bị xoá và một thư mới sẽ được tạo kèm theo nhãn hệ thống
SENT
. Bản nháp được biểu thị bằng một tài nguyên nháp.
Các bước tiếp theo
Để tìm hiểu về cách phát triển bằng API Google Workspace, bao gồm cả cách xử lý việc xác thực và uỷ quyền, hãy tham khảo bài viết Bắt đầu với tư cách là nhà phát triển Google Workspace.
Để tìm hiểu cách định cấu hình và chạy một ứng dụng Gmail API đơn giản, hãy đọc phần Tổng quan về hướng dẫn bắt đầu nhanh.