Gmail API

Gmail API cho phép bạn xem và quản lý dữ liệu hộp thư Gmail như chuỗi thư, thư và nhãn.

Dịch vụ: gmail.googleapis.com

Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần sử dụng thư viện của riêng mình để gọi dịch vụ này, hãy sử dụng thông tin sau khi bạn tạo các yêu cầu API.

Tài liệu khám phá

Tài liệu khám phá là một bản đặc tả có thể đọc được bằng máy để mô tả và sử dụng các API REST. Thư viện này dùng để tạo thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau:

Điểm cuối dịch vụ

Điểm cuối của dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối dịch vụ sau và tất cả URI dưới đây đều liên quan đến điểm cuối dịch vụ này:

  • https://gmail.googleapis.com

Tài nguyên REST: v1.users

Phương thức
getProfile GET /gmail/v1/users/{userId}/profile
Lấy hồ sơ Gmail của người dùng hiện tại.
stop POST /gmail/v1/users/{userId}/stop
Ngừng nhận thông báo đẩy cho hộp thư của người dùng đã cho.
watch POST /gmail/v1/users/{userId}/watch
Thiết lập hoặc cập nhật chế độ xem thông báo đẩy trên hộp thư của người dùng đã cho.

Tài nguyên REST: v1.users.drafts

Phương thức
create POST /gmail/v1/users/{userId}/drafts
POST /upload/gmail/v1/users/{userId}/drafts
Tạo một bản nháp mới có nhãn DRAFT.
delete DELETE /gmail/v1/users/{userId}/drafts/{id}
Xoá ngay lập tức và vĩnh viễn thư nháp đã chỉ định.
get GET /gmail/v1/users/{userId}/drafts/{id}
Lấy bản nháp đã chỉ định.
list GET /gmail/v1/users/{userId}/drafts
Liệt kê các thư nháp trong hộp thư của người dùng.
send POST /gmail/v1/users/{userId}/drafts/send
POST /upload/gmail/v1/users/{userId}/drafts/send
Gửi bản nháp hiện có, được chỉ định đến người nhận trong tiêu đề To, Cc và Bcc.
update PUT /gmail/v1/users/{userId}/drafts/{id}
PUT /upload/gmail/v1/users/{userId}/drafts/{id}
Thay thế nội dung của một bản nháp.

Tài nguyên REST: v1.users.history

Phương thức
list GET /gmail/v1/users/{userId}/history
Liệt kê nhật ký của tất cả thay đổi đối với hộp thư đã cho.

Tài nguyên REST: v1.users.labels

Phương thức
create POST /gmail/v1/users/{userId}/labels
Tạo nhãn mới.
delete DELETE /gmail/v1/users/{userId}/labels/{id}
Xoá vĩnh viễn và ngay lập tức nhãn đã chỉ định, đồng thời xoá nhãn đó khỏi mọi tin nhắn và chuỗi tin nhắn được áp dụng nhãn.
get GET /gmail/v1/users/{userId}/labels/{id}
Lấy nhãn đã chỉ định.
list GET /gmail/v1/users/{userId}/labels
Liệt kê tất cả nhãn trong hộp thư của người dùng.
patch PATCH /gmail/v1/users/{userId}/labels/{id}
Vá nhãn đã chỉ định.
update PUT /gmail/v1/users/{userId}/labels/{id}
Cập nhật nhãn đã chỉ định.

Tài nguyên REST: v1.users.messages

Phương thức
batchDelete POST /gmail/v1/users/{userId}/messages/batchDelete
Xoá nhiều thư theo mã thư.
batchModify POST /gmail/v1/users/{userId}/messages/batchModify
Sửa đổi nhãn trên các thông báo được chỉ định.
delete DELETE /gmail/v1/users/{userId}/messages/{id}
Xoá vĩnh viễn và ngay lập tức thư đã chỉ định.
get GET /gmail/v1/users/{userId}/messages/{id}
Lấy thông báo đã chỉ định.
import POST /gmail/v1/users/{userId}/messages/import
POST /upload/gmail/v1/users/{userId}/messages/import
Chỉ nhập thư vào hộp thư của người dùng này, với tính năng quét và phân loại email gửi tiêu chuẩn tương tự như nhận qua SMTP.
insert POST /gmail/v1/users/{userId}/messages
POST /upload/gmail/v1/users/{userId}/messages
Trực tiếp chèn một thư vào hộp thư của người dùng này tương tự như IMAP APPEND, bỏ qua hầu hết các hoạt động quét và phân loại.
list GET /gmail/v1/users/{userId}/messages
Liệt kê các thư trong hộp thư của người dùng.
modify POST /gmail/v1/users/{userId}/messages/{id}/modify
Sửa đổi nhãn trên thư được chỉ định.
send POST /gmail/v1/users/{userId}/messages/send
POST /upload/gmail/v1/users/{userId}/messages/send
Gửi thông báo đã chỉ định đến người nhận trong tiêu đề To, Cc và Bcc.
trash POST /gmail/v1/users/{userId}/messages/{id}/trash
Di chuyển thư đã chỉ định vào thùng rác.
untrash POST /gmail/v1/users/{userId}/messages/{id}/untrash
Xoá thư đã chỉ định khỏi thùng rác.

Tài nguyên REST: v1.users.messages.attachments

Phương thức
get GET /gmail/v1/users/{userId}/messages/{messageId}/attachments/{id}
Lấy tệp đính kèm thư đã chỉ định.

Tài nguyên REST: v1.users.settings

Phương thức
getAutoForwarding GET /gmail/v1/users/{userId}/settings/autoForwarding
Lấy chế độ cài đặt tự động chuyển tiếp cho tài khoản đã chỉ định.
getImap GET /gmail/v1/users/{userId}/settings/imap
Lấy chế độ cài đặt IMAP.
getLanguage GET /gmail/v1/users/{userId}/settings/language
Lấy chế độ cài đặt ngôn ngữ.
getPop GET /gmail/v1/users/{userId}/settings/pop
Lấy chế độ cài đặt POP.
getVacation GET /gmail/v1/users/{userId}/settings/vacation
Lấy chế độ cài đặt thư trả lời tự động.
updateAutoForwarding PUT /gmail/v1/users/{userId}/settings/autoForwarding
Cập nhật chế độ cài đặt tự động chuyển tiếp cho tài khoản được chỉ định.
updateImap PUT /gmail/v1/users/{userId}/settings/imap
Cập nhật chế độ cài đặt IMAP.
updateLanguage PUT /gmail/v1/users/{userId}/settings/language
Cập nhật chế độ cài đặt ngôn ngữ.
updatePop PUT /gmail/v1/users/{userId}/settings/pop
Cập nhật chế độ cài đặt POP.
updateVacation PUT /gmail/v1/users/{userId}/settings/vacation
Cập nhật chế độ cài đặt thư trả lời tự động khi nghỉ phép.

Tài nguyên REST: v1.users.settings.cse.identities

Phương thức
create POST /gmail/v1/users/{userId}/settings/cse/identities
Tạo và định cấu hình danh tính mã hoá phía máy khách được uỷ quyền gửi thư từ tài khoản người dùng.
delete DELETE /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Xoá một danh tính mã hoá phía máy khách.
get GET /gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
Truy xuất cấu hình danh tính mã hoá phía máy khách.
list GET /gmail/v1/users/{userId}/settings/cse/identities
Liệt kê các danh tính được mã hoá phía máy khách cho một người dùng đã xác thực.
patch PATCH /gmail/v1/users/{userId}/settings/cse/identities/{emailAddress}
Liên kết một cặp khoá khác với danh tính mã hoá phía máy khách hiện có.

Tài nguyên REST: v1.users.settings.cse.keypairs

Phương thức
create POST /gmail/v1/users/{userId}/settings/cse/keypairs
Tạo và tải chuỗi chứng chỉ khoá công khai S/MIME mã hoá phía máy khách và siêu dữ liệu khoá riêng tư cho người dùng đã xác thực.
disable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:disable
Tắt cặp khoá mã hoá phía máy khách.
enable POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:enable
Bật một cặp khoá mã hoá phía máy khách đã bị tắt.
get GET /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}
Truy xuất một cặp khoá mã hoá hiện có ở phía máy khách.
list GET /gmail/v1/users/{userId}/settings/cse/keypairs
Liệt kê các cặp khoá mã hoá phía máy khách cho một người dùng đã xác thực.
obliterate POST /gmail/v1/users/{userId}/settings/cse/keypairs/{keyPairId}:obliterate
Xoá vĩnh viễn và ngay lập tức một cặp khoá mã hoá phía máy khách.

Tài nguyên REST: v1.users.settings.delegates

Phương thức
create POST /gmail/v1/users/{userId}/settings/delegates
Thêm một người được uỷ quyền có trạng thái xác minh được đặt trực tiếp thành accepted mà không cần gửi email xác minh nào.
delete DELETE /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Xoá người được uỷ quyền đã chỉ định (có thể ở bất kỳ trạng thái xác minh nào) và thu hồi mọi quy trình xác minh có thể đã được yêu cầu để sử dụng người được uỷ quyền đó.
get GET /gmail/v1/users/{userId}/settings/delegates/{delegateEmail}
Lấy đối tượng uỷ quyền đã chỉ định.
list GET /gmail/v1/users/{userId}/settings/delegates
Liệt kê người được uỷ quyền cho tài khoản đã chỉ định.

Tài nguyên REST: v1.users.settings.filters

Phương thức
create POST /gmail/v1/users/{userId}/settings/filters
Tạo bộ lọc.
delete DELETE /gmail/v1/users/{userId}/settings/filters/{id}
Xoá ngay và vĩnh viễn bộ lọc đã chỉ định.
get GET /gmail/v1/users/{userId}/settings/filters/{id}
Lấy bộ lọc.
list GET /gmail/v1/users/{userId}/settings/filters
Liệt kê các bộ lọc thư của người dùng Gmail.

Tài nguyên REST: v1.users.settings.forwardingAddresses

Phương thức
create POST /gmail/v1/users/{userId}/settings/forwardingAddresses
Tạo địa chỉ chuyển tiếp.
delete DELETE /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Xoá địa chỉ chuyển tiếp đã chỉ định và thu hồi mọi quy trình xác minh có thể đã được yêu cầu.
get GET /gmail/v1/users/{userId}/settings/forwardingAddresses/{forwardingEmail}
Lấy địa chỉ chuyển tiếp đã chỉ định.
list GET /gmail/v1/users/{userId}/settings/forwardingAddresses
Liệt kê các địa chỉ chuyển tiếp cho tài khoản được chỉ định.

Tài nguyên REST: v1.users.settings.sendAs

Phương thức
create POST /gmail/v1/users/{userId}/settings/sendAs
Tạo bí danh "from" (từ) gửi dưới dạng tuỳ chỉnh.
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Xoá bí danh gửi dưới dạng đã chỉ định.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Lấy bí danh gửi dưới dạng đã chỉ định.
list GET /gmail/v1/users/{userId}/settings/sendAs
Liệt kê các bí danh gửi dưới dạng cho tài khoản đã chỉ định.
patch PATCH /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Vá bí danh gửi dưới dạng đã chỉ định.
update PUT /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}
Cập nhật bí danh gửi dưới dạng.
verify POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/verify
Gửi email xác minh đến địa chỉ đại diện gửi thư được chỉ định.

Tài nguyên REST: v1.users.settings.sendAs.smimeInfo

Phương thức
delete DELETE /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Xoá cấu hình S/MIME đã chỉ định cho bí danh gửi dưới dạng đã chỉ định.
get GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}
Lấy cấu hình S/MIME đã chỉ định cho bí danh gửi dưới dạng đã chỉ định.
insert POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Chèn (tải lên) cấu hình S/MIME đã cho cho bí danh gửi dưới dạng đã chỉ định.
list GET /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo
Liệt kê các cấu hình S/MIME cho bí danh gửi dưới dạng được chỉ định.
setDefault POST /gmail/v1/users/{userId}/settings/sendAs/{sendAsEmail}/smimeInfo/{id}/setDefault
Đặt cấu hình S/MIME mặc định cho bí danh gửi dưới dạng đã chỉ định.

Tài nguyên REST: v1.users.threads

Phương thức
delete DELETE /gmail/v1/users/{userId}/threads/{id}
Xoá ngay lập tức và vĩnh viễn chuỗi tin nhắn đã chỉ định.
get GET /gmail/v1/users/{userId}/threads/{id}
Lấy luồng đã chỉ định.
list GET /gmail/v1/users/{userId}/threads
Liệt kê các chuỗi thư trong hộp thư của người dùng.
modify POST /gmail/v1/users/{userId}/threads/{id}/modify
Sửa đổi các nhãn được áp dụng cho luồng.
trash POST /gmail/v1/users/{userId}/threads/{id}/trash
Di chuyển luồng đã chỉ định vào thùng rác.
untrash POST /gmail/v1/users/{userId}/threads/{id}/untrash
Xoá luồng đã chỉ định khỏi thùng rác.