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