REST Resource: users.settings.delegates
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Uỷ quyền
Chế độ cài đặt cho 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ệ cho tài khoản của người uỷ quyền. Hãy xem bài viết "Thiết lập tính năng uỷ quyền gửi thư" để biết thêm thông tin về người được uỷ quyền.
| Biểu diễn dưới dạng JSON |
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| Trường |
delegateEmail |
string
Địa chỉ email của người được uỷ quyền.
|
verificationStatus |
enum (VerificationStatus)
Cho biết địa chỉ này đã được xác minh hay chưa và có thể đóng vai trò là người được uỷ quyền cho tài khoản hay không. Chỉ có thể đọc.
|
VerificationStatus
Cho biết liệu quyền sở hữu địa chỉ email có được xác minh để sử dụng tính năng uỷ quyền hay không.
| Enum |
verificationStatusUnspecified |
Trạng thái xác minh không xác định. |
accepted |
Địa chỉ này có thể đóng vai trò là người được uỷ quyền cho tài khoản. |
pending |
Chúng tôi đã gửi yêu cầu xác minh đến địa chỉ đó nhưng chủ sở hữu chưa chấp nhận yêu cầu. |
rejected |
Chúng tôi đã gửi yêu cầu xác minh đến địa chỉ đó nhưng chủ sở hữu đã từ chối. |
expired |
Chúng tôi đã gửi yêu cầu xác minh đến địa chỉ đó qua đường bưu điện nhưng yêu cầu này đã hết hạn mà không được xác minh. |
Phương thức |
|
|
Thêm người được uỷ quyền với 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. |
|
|
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 đó. |
|
|
Lấy đối tượng uỷ quyền đã chỉ định. |
|
|
Liệt kê người được uỷ quyền cho tài khoản đã chỉ định. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# REST Resource: users.settings.delegates\n\n- [Resource: Delegate](#Delegate)\n - [JSON representation](#Delegate.SCHEMA_REPRESENTATION)\n- [VerificationStatus](#VerificationStatus)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Delegate\n------------------\n\nSettings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See [\"Set up mail delegation\"](https://support.google.com/mail/answer/138350) for more information about delegates.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"delegateEmail\": string, \"verificationStatus\": enum (/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus) } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `delegateEmail` | `string` The email address of the delegate. |\n| `verificationStatus` | `enum (`[VerificationStatus](/workspace/gmail/api/reference/rest/v1/users.settings.delegates#VerificationStatus)`)` Indicates whether this address has been verified and can act as a delegate for the account. Read-only. |\n\nVerificationStatus\n------------------\n\nIndicates whether ownership of an email address has been verified for delegation use.\n\n| Enums ||\n|---------------------------------|------------------------------------------------------------------------------------------|\n| `verificationStatusUnspecified` | Unspecified verification status. |\n| `accepted` | The address can act a delegate for the account. |\n| `pending` | A verification request was mailed to the address, and the owner has not yet accepted it. |\n| `rejected` | A verification request was mailed to the address, and the owner rejected it. |\n| `expired` | A verification request was mailed to the address, and it expired without verification. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/create) | Adds a delegate with its verification status set directly to `accepted`, without sending any verification email. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/delete) | Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/get) | Gets the specified delegate. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.settings.delegates/list) | Lists the delegates for the specified account. |"]]
