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