מוסיף נציג עם סטטוס האימות שלו שמוגדר ישירות ל-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
ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.