Method: users.settings.delegates.list

מציגה את בעלי הגישה לחשבון שצוין.

השיטה הזו זמינה רק ללקוחות של חשבונות שירות שהוענקה להם הרשאה ברמת הדומיין.

בקשת HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
userId

string

כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תשובה לשיטה delegates.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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.