Method: users.settings.delegates.list
רשימה של המשתמשים שקיבלו הרשאה בחשבון שצוין.
השיטה הזאת זמינה רק ללקוחות של חשבונות שירות שקיבלו הרשאה ברמת הדומיין.
בקשת HTTP
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים |
userId |
string
כתובת האימייל של המשתמש. הערך המיוחד 'me' יכול לשמש לציון המשתמש המאומת.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה ל-method leges.list.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
{
"delegates": [
{
object (Delegate )
}
]
} |
שדות |
delegates[] |
object (Delegate )
רשימת המשתמשים שקיבלו הרשאה (עם כל סטטוס אימות). אם לחשבון אין משתמשים עם הרשאות גישה, השדה הזה לא יופיע.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/gmail.settings.basic
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly
מידע נוסף זמין במדריך להרשאות.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-05 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-05 (שעון UTC)."],[[["Lists delegates for a specified account, accessible only to service accounts with domain-wide authority."],["Employs a `GET` request to the endpoint `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates`, using gRPC Transcoding syntax."],["Requires an empty request body and returns a JSON response containing a list of delegates, if any."],["Needs authorization with specific OAuth scopes like `https://www.googleapis.com/auth/gmail.settings.basic` or `https://www.googleapis.com/auth/gmail.modify`."]]],["A `GET` request is made to `https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates` to list an account's delegates. The `userId` path parameter, which can be \"me,\" specifies the user. The request body must be empty. The response body, if successful, includes a JSON structure with a list of delegate objects under the \"delegates\" field. This action requires service account clients with domain-wide authority and specific OAuth scopes.\n"]]