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, 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 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 tin nhắn
- Tiêu chuẩn hoá chữ ký email trong một tổ chức
Thuật ngữ thường gặp
Sau đây là danh sách các thuật ngữ thường gặp được dùng trong API này:
- Người uỷ quyền và người được uỷ quyền
- Người uỷ quyền là người dùng Gmail cấp quyền truy cập vào hộp thư cho một người dùng khác trong cùng một tổ chức Google Workspace. Người dùng nhận được quyền truy cập này là người được uỷ quyền. Người được uỷ quyền có thể đọc, gửi và xoá tin nhắn, cũng như xem và thêm người liên hệ thay mặt cho tài khoản của người uỷ quyền. Để biết thêm thông tin, hãy xem Quản lý người được uỷ quyền.
- Thư nháp
- Tin nhắn chưa gửi. Bạn có thể thay thế tin nhắn có trong thư nháp.
Khi bạn gửi thư nháp, hệ thống sẽ tự động xoá thư nháp đó và tạo một tin nhắn có nhãn hệ thống
SENT. Thư nháp được biểu thị bằng tài nguyêndrafts. Để biết thêm thông tin, hãy xem bài viết Sử dụng thư nháp. - Bộ lọc
- Các quy tắc nâng cao được định cấu hình cho một tài khoản để đánh giá các tin nhắn đến dựa trên các tiêu chí khớp cụ thể (như người gửi, tiêu đề hoặc kích thước). Khi một tin nhắn khớp, bộ lọc sẽ tự động kích hoạt các hành động như thêm hoặc xoá nhãn, hoặc chuyển tiếp email đến một địa chỉ được chỉ định. Để biết thêm thông tin, hãy xem bài viết Quản lý bộ lọc.
- Địa chỉ chuyển tiếp
- Các địa chỉ email cụ thể, đã xác minh được định cấu hình để nhận tin nhắn được tự động chuyển tiếp từ tài khoản của người dùng. Trước khi có thể sử dụng một địa chỉ trong quy tắc hoặc bộ lọc chuyển tiếp, bạn phải đăng ký và xác minh chính thức để chứng minh quyền sở hữu. Để biết thêm thông tin, hãy xem Quản lý tính năng chuyển tiếp.
- Nhãn
Cơ chế sắp xếp tin nhắn và luồng. Ví dụ: bạn có thể tạo và áp dụng nhãn "thuế" cho tất cả tin nhắn và luồng liên quan đến thuế của người dùng. Để biết thêm thông tin, hãy xem bài viết Quản lý nhãn.
Có 2 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,TRASHhoặ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ưINBOXkhỏi tin nhắn và luồng. - Nhãn người dùng
- Các 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 tài nguyên
labels.
- Tin nhắn
Nội dung email chứa 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 tin nhắn. Tin nhắn được biểu thị bằng tài nguyên
messages.- Thông báo đẩy
Hệ thống thông báo phía máy chủ tích hợp với Google Cloud Pub/Sub. Các ứng dụng có thể "theo dõi" một hộp thư và API Gmail sẽ gửi cảnh báo hoặc webhook tự động bất cứ khi nào có thay đổi (chẳng hạn như email mới đến), giúp loại bỏ nhu cầu ứng dụng liên tục thăm dò máy chủ để cập nhật. Để biết thêm thông tin, hãy xem bài viết Thông báo đẩy.
- Chứng chỉ S/MIME
Các chứng chỉ kỹ thuật số được tải lên các email đại diện gửi dưới dạng cụ thể cho phép người dùng gửi email được mã hoá và ký kỹ thuật số, đảm bảo tính bảo mật của tin nhắn và tính xác thực của người gửi. Để biết thêm thông tin, hãy xem bài viết Quản lý chứng chỉ S/MIME.
- Email đại diện gửi dưới dạng
Các email đại diện này biểu thị nhiều địa chỉ email mà một tài khoản được uỷ quyền gửi thư. Mỗi tài khoản có ít nhất một email đại diện biểu thị địa chỉ email chính. Email đại diện tương ứng với tính năng "Gửi thư dưới dạng" trong giao diện web Gmail và cũng là cơ sở để định cấu hình chữ ký email cho mỗi địa chỉ. Để biết thêm thông tin, hãy xem bài viết Quản lý email đại diện.
- 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 khách, một luồng được tạo khi một hoặc nhiều người nhận phản hồi một tin nhắn bằng tin nhắn của riêng họ. Để biết thêm thông tin, hãy xem bài viết Quản lý luồng.
Chủ đề có liên quan
Để tìm hiểu về cách phát triển bằng API Google Workspace, bao gồm cả cách xử lý quy trình xác thực và uỷ quyền, hãy tham khảo bài viết Phát triển trên Google Workspace.
Để tìm hiểu cách định cấu hình và chạy ứng dụng API Gmail, hãy đọc bài viết Bắt đầu nhanh.