REST Resource: users.settings.delegates
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: المفوَّض
إعدادات مفوَّض يمكن للمفوَّضين قراءة الرسائل وإرسالها وحذفها، بالإضافة إلى عرض جهات الاتصال وإضافتها، وذلك في حساب المفوِّض. اطّلِع على مقالة "إعداد تفويض البريد" للحصول على مزيد من المعلومات عن المستخدمين المفوَّضين.
| الحقول |
delegateEmail |
string
عنوان البريد الإلكتروني للمفوَّض
|
verificationStatus |
enum (VerificationStatus)
يشير إلى ما إذا تم إثبات صحة هذا العنوان وما إذا كان يمكنه التصرف كمفوّض للحساب. للقراءة فقط.
|
VerificationStatus
تشير إلى ما إذا تم إثبات ملكية عنوان بريد إلكتروني لاستخدامه في التفويض.
| عمليات التعداد |
verificationStatusUnspecified |
حالة إثبات الهوية غير محدّدة. |
accepted |
يمكن أن يعمل العنوان كمفوّض للحساب. |
pending |
تم إرسال طلب إثبات الملكية بالبريد إلى العنوان، ولم يوافق المالك عليه بعد. |
rejected |
تم إرسال طلب إثبات الملكية بالبريد إلى العنوان، ورفضه المالك. |
expired |
تم إرسال طلب إثبات الملكية بالبريد إلى العنوان، وانتهت صلاحيته بدون إثبات الملكية. |
الطُرق |
|
|
تُضيف مستخدمًا مفوَّضًا تم ضبط حالة إثبات ملكيته على accepted مباشرةً، بدون إرسال أي رسالة إلكترونية لإثبات الملكية. |
|
|
تزيل هذه العملية المستخدم المفوَّض المحدّد (الذي يمكن أن يكون لديه أي حالة إثبات ملكية)، وتُلغي أي عملية إثبات ملكية قد تكون مطلوبة لاستخدامه. |
|
|
الحصول على المفوَّض المحدَّد |
|
|
يسرد المستخدمين المفوَّضين للحساب المحدّد. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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. |"]]
