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