REST Resource: users.settings.delegates
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: הענקת גישה
ההגדרות של מי שקיבל הרשאה. בעלי הגישה יכולים לקרוא, לשלוח ולמחוק הודעות, וגם להציג ולהוסיף אנשי קשר בחשבון של מעניק הגישה. מידע נוסף על הענקת גישה לחשבון הדואר האלקטרוני זמין במאמר הגדרת הענקת גישה לחשבון הדואר האלקטרוני.
| שדות |
delegateEmail |
string
כתובת האימייל של המשתמש להענקת הגישה.
|
verificationStatus |
enum (VerificationStatus)
מציין אם הכתובת הזו אומתה ויכולה לשמש כגורם מטעם החשבון. קריאה בלבד.
|
VerificationStatus
מציין אם הבעלות על כתובת אימייל אומתה לצורך הענקת גישה.
| טיפוסים בני מנייה (enum) |
verificationStatusUnspecified |
סטטוס אימות לא צוין. |
accepted |
הכתובת יכולה לשמש כגורם מטעם החשבון. |
pending |
בקשת אימות נשלחה בדואר לכתובת, והבעלים עדיין לא אישר אותה. |
rejected |
נשלחה בקשת אימות בדואר לכתובת, והבעלים דחה אותה. |
expired |
בקשת אימות נשלחה בדואר לכתובת, ופג תוקפה בלי שהיא אומתה. |
Methods |
|
|
הוספת אדם עם הרשאת גישה, כאשר סטטוס האימות שלו מוגדר ישירות ל-accepted, בלי לשלוח אימייל אימות. |
|
|
הפונקציה מסירה את המשתמש המורשה שצוין (שיכול להיות בכל סטטוס אימות) ומבטלת את כל האימותים שנדרשו לשימוש בו. |
|
|
אחזור של הנציג שצוין. |
|
|
הצגת רשימת האנשים שקיבלו הרשאות גישה לחשבון שצוין. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
