API Gmail 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 được uỷ quyền vào dữ liệu Gmail của người dùng và phù hợp với nhiều ứng dụng, chẳng hạn như:
- Trích xuất, lập chỉ mục và sao lưu thư chỉ có quyền đọc
- Gửi tin nhắn tự động hoặc theo lập 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 trên toàn tổ chức
Sau đây là danh sách các thuật ngữ thường dùng trong API Gmail:
- Tin nhắn
- Email chứa người gửi, người nhận, tiêu đề và nội dung. Sau khi tạo thông báo, bạn không thể thay đổi 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 tập hợp các tin nhắn có liên quan tạo thành một cuộc trò chuyện. Trong ứng dụng email, một chuỗi thư được tạo khi một hoặc nhiều người nhận trả lời một thư bằng thư của riêng họ.
- Nhãn
Cơ chế sắp xếp tin nhắn và chuỗi tin nhắn. Ví dụ: bạn có thể tạo nhãn "thuế" và áp dụng cho tất cả thư và chuỗi tin nhắn 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 bên trong tạo, chẳng hạn như
INBOX,TRASHhoặcSPAM. Bạn không thể xoá hoặc sửa đổi các nhãn này. Tuy nhiên, một số nhãn hệ thống, chẳng hạn nhưINBOX, có thể được áp dụng hoặc xoá khỏi thư và chuỗi tin nhắn. - 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. Việc gửi thư nháp sẽ tự động xoá thư nháp và tạo một thư có 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ả việc xử lý xác thực và uỷ quyền, hãy tham khảo bài viết Bắt đầu làm 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 API Gmail đơn giản, hãy đọc nội dung Tổng quan về hướng dẫn bắt đầu nhanh.