Tổng quan về Gmail API

Gmail API là một API dựa trên REST 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ư:

  • Chỉ đọc dữ liệu trích xuất, lập chỉ mục và sao lưu thư
  • 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

Thuật ngữ thường gặp

Sau đây là danh sách các thuật ngữ thường 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á thư, 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 bài viết Quản lý người được uỷ quyền.
Draft
Một tin nhắn chưa gửi. Bạn có thể thay thế một thư 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 tài nguyên drafts. Để biết thêm thông tin, hãy xem phần Làm việc với bản 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 thư đến dựa trên tiêu chí khớp cụ thể (chẳng hạn như người gửi, tiêu đề hoặc kích thước). Khi một thư trùng 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ụ thể. Để 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
Địa chỉ email cụ thể, đã xác minh được thiết lập để nhận thư 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 chuyển tiếp hoặc bộ lọc, địa chỉ đó phải được đă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 bài viết Quản lý việc chuyển tiếp.
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 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. Để biết thêm thông tin, hãy xem bài viết Quản lý nhãn.

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ặc SPAM. 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, 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 tài nguyên labels.
Tin nhắn

Một 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 thông báo. Thông báo được biểu thị bằng tài nguyên messages.

Thông báo đẩy

Một 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à Gmail API sẽ gửi webhook hoặc cảnh báo tự động bất cứ khi nào có thay đổi (chẳng hạn như khi có email mới), giúp ứng dụng không cần 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

Chứng chỉ số được tải lên các bí danh gửi dưới tên riêng biệt cho phép người dùng gửi email được mã hoá và ký bằng chữ ký số, đảm bảo tính bảo mật của thư 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 thư

Đây là những địa chỉ email mà một tài khoản được phép gửi thư. Mỗi tài khoản đều có ít nhất một biệt hiệu đại diện cho địa chỉ email chính. Bí danh tương ứng với tính năng "Gửi thư dưới tên" trong giao diện web của Gmail và cũng là cơ sở để định cấu hình chữ ký email cho từng địa chỉ. Để biết thêm thông tin, hãy xem phần Quản lý bí danh.

Luồng

Một nhóm 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 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ọ. Để biết thêm thông tin, hãy xem phần Quản lý các luồng.