REST Resource: users.settings.sendAs

משאב: SendAs

הגדרות המשויכות לכינוי 'שליחה כ', שיכול להיות כתובת ההתחברות הראשית שמשויכת לחשבון או 'מאת' בהתאמה אישית address. כתובות האימייל החלופיות 'שליחה בשם' תואמות לתכונה "שליחת אימייל בשם" בממשק האינטרנט.

ייצוג JSON
{
  "sendAsEmail": string,
  "displayName": string,
  "replyToAddress": string,
  "signature": string,
  "isPrimary": boolean,
  "isDefault": boolean,
  "treatAsAlias": boolean,
  "smtpMsa": {
    object (SmtpMsa)
  },
  "verificationStatus": enum (VerificationStatus)
}
שדות
sendAsEmail

string

כתובת האימייל שמופיעה בקטע 'מאת:' הכותרת לאימייל שנשלח באמצעות הכינוי הזה. זוהי קריאה בלבד לכל הפעולות מלבד יצירה.

displayName

string

שם שמופיע בשדה 'מאת:' הכותרת לאימייל שנשלח באמצעות הכינוי הזה. בשדה 'מאת' בהתאמה אישית אם השדה ריק, Gmail יאכלס את השדה 'מאת:' עם השם המשמש לכתובת הראשית המשויכת לחשבון. אם האדמין השבית את האפשרות של משתמשים לעדכן את פורמט השם שלהם, בקשות לעדכון השדה הזה בהתחברות הראשית ייכשלו באופן שקט.

replyToAddress

string

כתובת אימייל אופציונלית שמופיעה בשדה 'תשובה ל:' הכותרת לאימייל שנשלח באמצעות הכינוי הזה. אם השדה ריק, Gmail לא ייצור תשובה מסוג 'תשובה ל:'. הכותרת.

signature

string

חתימת HTML אופציונלית שכלולה בהודעות שנשלחות עם הכינוי הזה בממשק המשתמש של Gmail באינטרנט. החתימה הזו תתווסף רק לאימיילים חדשים.

isPrimary

boolean

האם הכתובת הזו היא הכתובת הראשית שמשמשת להתחברות לחשבון. לכל חשבון Gmail יש רק כתובת ראשית אחת, ואי אפשר למחוק אותה מהאוסף של כתובות האימייל החלופיות. השדה הזה הוא לקריאה בלבד.

isDefault

boolean

האם הכתובת הזו מסומנת כברירת המחדל בשדה 'מאת:' כתובת במצבים כמו כתיבת הודעה חדשה או שליחת תשובה אוטומטית לחופשה. לכל חשבון Gmail יש רק כתובת 'שליחה כ' שמוגדרת כברירת מחדל, כך שהערך החוקי היחיד שלקוחות יכולים לכתוב בשדה הזה הוא true. שינוי מ-false ל-true של כתובת מסוימת יגרום להפיכת השדה הזה ל-false עבור כתובת ברירת המחדל הקודמת השנייה.

treatAsAlias

boolean

האם Gmail צריך להתייחס לכתובת הזו ככינוי של כתובת האימייל הראשית של המשתמש. ההגדרה הזו חלה רק על פרמטרים מותאמים אישית בשדה 'מאת' כינויים.

smtpMsa

object (SmtpMsa)

שירות SMTP אופציונלי שישמש כממסר יוצא עבור אימייל שנשלח באמצעות הכינוי הזה. אם השדה הזה ריק, דואר יוצא יישלח ישירות מהשרתים של Gmail לשירות ה-SMTP של היעד. ההגדרה הזו חלה רק על פרמטרים מותאמים אישית בשדה 'מאת' כינויים.

verificationStatus

enum (VerificationStatus)

מציין אם הכתובת הזו אומתה לשימוש ככינוי שליחה. קריאה בלבד. ההגדרה הזו חלה רק על פרמטרים מותאמים אישית בשדה 'מאת' כינויים.

SmtpMsa

הגדרה לתקשורת עם שירות SMTP.

ייצוג JSON
{
  "host": string,
  "port": integer,
  "username": string,
  "password": string,
  "securityMode": enum (SecurityMode)
}
שדות
host

string

שם המארח של שירות ה-SMTP. חובה.

port

integer

היציאה של שירות ה-SMTP. חובה.

username

string

שם המשתמש שישמש לאימות עם שירות ה-SMTP. זהו שדה לכתיבה בלבד שניתן לציין בבקשות ליצירה או לעדכון של הגדרות SendAs; הוא אף פעם לא מאוכלס בתגובות.

password

string

הסיסמה שתשמש לאימות עם שירות ה-SMTP. זהו שדה לכתיבה בלבד שניתן לציין בבקשות ליצירה או לעדכון של הגדרות SendAs; הוא אף פעם לא מאוכלס בתגובות.

securityMode

enum (SecurityMode)

הפרוטוקול שישמש לאבטחת התקשורת עם שירות ה-SMTP. חובה.

SecurityMode

פרוטוקול שיכול לשמש לאבטחת תקשורת עם שירות ה-SMTP.

טיפוסים בני מנייה (enum)
securityModeUnspecified מצב אבטחה לא מוגדר.
none התקשורת עם שירות ה-SMTP המרוחק אינה מאובטחת. נדרשת יציאה 25.
ssl התקשורת עם שירות ה-SMTP המרוחק מאובטחת באמצעות SSL.
starttls התקשורת עם שירות ה-SMTP המרוחק מאובטחת באמצעות STARTTLS.

VerificationStatus

מציין אם הבעלות על כתובת אומתה לצורך שימושה ככינוי שליחה.

טיפוסים בני מנייה (enum)
verificationStatusUnspecified סטטוס האימות לא צוין.
accepted הכתובת מוכנה לשימוש כאימייל חלופי.
pending הכתובת ממתינה לאימות של הבעלים.

שיטות

create

יצירת ערך מותאם אישית בשדה 'מאת' שליחה ככינוי.

delete

מחיקת כינוי השליחה שצוין.

get

קבלת כתובת האימייל החלופית שצוינה.

list

רשימה של כינויי השליחה של החשבון שצוין.

patch

מתקנים את כינויי השליחה שצוינו.

update

מעדכן כתובת אימייל חלופית.

verify

שולח הודעת אימות לכתובת האימייל החלופית שצוינה.