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, API Gmail là lựa chọn tốt nhất để có quyền 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ó thể đọ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 trên toàn 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
- 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 đượ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 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
,TRASH
hoặ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 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. 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 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.