REST Resource: users.settings.delegates
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
منبع: نماینده
تنظیمات برای یک نماینده نمایندگان می‌توانند پیام‌ها را بخوانند، ارسال کنند و حذف کنند، و همچنین مخاطبین را برای حساب نماینده‌دهنده مشاهده و اضافه کنند. برای اطلاعات بیشتر درباره نمایندگان، به «تنظیم نمایندگی ایمیل» مراجعه کنید.
| نمایندگی JSON |
|---|
{
"delegateEmail": string,
"verificationStatus": enum (VerificationStatus)
} |
| فیلدها |
|---|
delegateEmail | string آدرس ایمیل نماینده |
verificationStatus | enum ( VerificationStatus ) نشان می دهد که آیا این آدرس تأیید شده است و می تواند به عنوان نماینده حساب عمل کند. فقط خواندنی |
وضعیت تأیید
نشان می دهد که آیا مالکیت یک آدرس ایمیل برای استفاده از نمایندگی تأیید شده است یا خیر.
| Enums |
|---|
verificationStatusUnspecified | وضعیت تأیید نامشخص |
accepted | آدرس می‌تواند نماینده حساب باشد. |
pending | یک درخواست تأیید به آدرس پست شد و مالک هنوز آن را نپذیرفته است. |
rejected | یک درخواست تأیید به آدرس پست شد و مالک آن را رد کرد. |
expired | یک درخواست تأیید به آدرس پست شد و بدون تأیید منقضی شد. |
روش ها |
|---|
| نماینده‌ای را با وضعیت تأیید مستقیماً به accepted اضافه می‌کند، بدون ارسال ایمیل تأیید. |
| نماینده مشخص شده را حذف می کند (که می تواند از هر وضعیت تأییدی باشد) و هر تأییدیه ای را که ممکن است برای استفاده از آن لازم بوده باشد لغو می کند. |
| نماینده مشخص شده را دریافت می کند. |
| نمایندگان را برای حساب مشخص شده فهرست می کند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[],[],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. |"]]
