מוסיף נציג עם סטטוס האימות שלו שמוגדר ישירות ל-accepted, בלי לשלוח אימייל אימות. המשתמש שמוגדר כנציג חייב להיות חבר באותו ארגון Google Workspace כמו המשתמש שנותן את ההרשאה. מידע נוסף מופיע במאמר בנושא ניהול משתמשים עם הרשאה.
ב-Gmail יש מגבלות על מספר הנציגים והמשתמשים שנותנים הרשאה לניהול שיחות שכל משתמש בארגון Google Workspace יכול להגדיר. המגבלות האלה משתנות בהתאם לארגון, אבל באופן כללי, לכל משתמש יכולים להיות עד 25 בעלי גישה ועד 10 משתמשים שהעניקו גישה.
צריך לציין את כתובת האימייל הראשית של המשתמש שמוגדר כנציג, ולא כתובת אימייל חלופית.
כשיוצרים נציג חדש, יכול להיות שיחול עיכוב של עד דקה לפני שהנציג החדש יהיה זמין לשימוש.
השיטה הזו זמינה רק ללקוחות של חשבונות שירות שהוענקה להם הרשאה ברמת הדומיין.
בקשת HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/delegates
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
פרמטרים של נתיב
| פרמטרים | |
|---|---|
userId |
כתובת האימייל של המשתמש. אפשר להשתמש בערך המיוחד me כדי לציין את המשתמש המאומת. |
גוף הבקשה
גוף הבקשה מכיל מופע של Delegate.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Delegate.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/gmail.settings.sharing
מידע נוסף זמין במדריך ההרשאות.