API Gmail là một API RESTful có thể dùng để truy cập vào hộp thư của Gmail và gửi thư. Đối với hầu hết ứng dụng web, API Gmail 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ế độ chỉ đọc
- Gửi tin nhắn tự động hoặc có lập trình
- Di chuyển tài khoản email
- Sắp xếp email, bao gồm cả tính năng 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ữ phổ biến được sử dụng trong API Gmail:
- Tin nhắn
- Một 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 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 thông điệp liên quan để tạo nên một cuộc trò chuyện. Trong ứng dụng email, một chuỗi được hình thành khi một hoặc nhiều người nhận trả lời một thư bằng thư của chính họ.
- Nhãn
Cơ chế sắp xếp các thông báo và chuỗi. Ví dụ: bạn có thể tạo và áp dụng nhãn "thuế" cho tất cả thông báo và luồng liên quan đến các khoản thuế của người dùng. Có hai loại nhãn:
- Nhãn hệ thống
- Các nhãn được tạo nội bộ, chẳng hạn như
INBOX
,TRASH
hoặcSPAM
. 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 các thư và luồng. - 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 thư chưa được gửi. Bạn có thể thay thế thư nằm trong thư nháp. Thao tác gửi thư nháp sẽ tự động xoá thư nháp và tạo tin nhắn có nhãn hệ thống
SENT
. Bản nháp được biểu thị bằng một tài nguyên bả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ý hoạt động 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 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 phần Tổng quan nhanh.