אפליקציות App Engine יכולות לשלוח הודעות אימייל בשם כתובות לקבלת אימייל של האפליקציה ובשם משתמשים מסוימים עם חשבונות Google. אפליקציות יכולות לקבל אימייל בכתובות שונות. אפליקציות שולחות הודעות באמצעות שירות הדואר ומקבלות הודעות בצורה של בקשות HTTP שמופעלות על ידי App Engine ונשלחות לאפליקציה.
שליחת אימייל
שירות האימייל יכול לשלוח הודעות אימייל לנמען אחד או יותר. הודעה כוללת נושא, גוף בטקסט פשוט וגוף אופציונלי ב-HTML. היא יכולה לכלול גם קבצים מצורפים ומערך מוגבל של כותרות.
אפשר להשתמש בכל כתובת אימייל של נמען. נמען יכול להיות בשדה 'אל' של ההודעה, בשדה 'עותק' או מוסתר מנמעני ההודעה (עותק מוסתר או 'עותק סמוי').
כשיישום קורא לשירות הדואר כדי לשלוח הודעה, ההודעה מתווספת לתור והקריאה חוזרת באופן מיידי. שירות הדואר משתמש בהליכים סטנדרטיים כדי ליצור קשר עם שרת הדואר של כל נמען, להעביר את ההודעה ולנסות שוב אם אי אפשר ליצור קשר עם שרת הדואר.
מי יכול לשלוח אימייל
מטעמי אבטחה, כתובת השולח של הודעה חייבת להיות אחת מהאפשרויות הבאות:
- חשבון Gmail או חשבון Google Workspace של המשתמש שמחובר כרגע
- כל כתובת אימייל בפורמט
anything@[MY_PROJECT_ID].appspotmail.comאוanything@[MY_PROJECT_NUMBER].appspotmail.com - כל כתובת אימייל שמופיעה במסוף בקטע שולחים מורשים של Email API Google Cloud
כל כתובות האימייל ברשימה Email API Authorized Senders צריכות להיות חשבונות תקינים ב-Gmail או בדומיין שמארח Google. אדמינים של אפליקציות יכולים להוסיף את החשבונות הבאים לרשימת השולחים המורשים:
- כתובת אימייל משלהם
- כל קבוצה שבה הם מוגדרים כבעלים או כמנהלים
- אפליקציות שמארחות בדומיין Google Workspace:
noreply@[DOMAIN].com, כל עודnoreply@[DOMAIN].comהוא חשבון תקף (משתמש או קבוצה).
בנוסף, אדמינים של דומיינים שמנוהלים על ידי Google Workspace יכולים להוסיף לרשימת השולחים המורשים כל משתמש בדומיין שלהם.
יש מגבלה של עד 50 שולחים מורשים.
אימייל מ-Google Workspace
אם אתם מתכוונים לשלוח אימייל מדומיין שמנוהל על ידי Google Workspace, כדאי להגדיר את רשומות ה-DNS של הדומיין כדי לציין ש-Google היא מקור מהימן לאימייל.SPF הוראות לביצוע הפעולה הזו זמינות במאמר בנושא רשומות SPF במרכז העזרה של Google Workspace.
חשוב לדעת שאם אתם משתמשים בכינויים שהוגדרו לדומיין שלכם ב-Google Workspace, לא תוכלו לשלוח אימייל מכתובות אימייל שמשתמשות בדומיין החלופי.
שליחת התראות על החזרת אימייל (bounce) אם האימייל לא נמסר
יכול להיות שלא נקבל למסירה אימייל שתואם לחתימה מוכרת של ספאם, וירוסים או תוכן זדוני אחר.
אם שירות האימייל לא יכול למסור הודעה, או אם שרת האימייל של הנמען מחזיר הודעה על אי-מסירה (לדוגמה, כי אין חשבון לכתובת הזו במערכת), אפשר לשלוח הודעת שגיאה באימייל לכתובת של השולח של ההודעה. האפליקציה עצמה לא מקבלת הודעה על כך שהמסירה הצליחה או נכשלה.
כברירת מחדל, ההתראות על אימיילים חוזרים מושבתות. כדי לקבל התראות על הודעות חוזרות באימייל, צריך להגדיר את האפליקציה. לפרטים נוספים, אפשר לעיין במאמר בנושא קבלת הודעה על החזרת אימייל.
דואר ושרת הפיתוח
אפשר להגדיר את שרת הפיתוח כך שישלח הודעות אימייל ישירות מהמחשב כשבודקים תכונה באפליקציה ששולחת הודעות. אתם יכולים להגדיר את שרת הפיתוח כך שישתמש בשרת SMTP שתבחרו. לחלופין, אפשר להגדיר את שרת הפיתוח כך שישתמש ב-Sendmail, אם Sendmail מותקן במחשב ומוגדר לשליחת אימייל.
אם לא תגדירו שרת SMTP או תפעילו את Sendmail, כשהאפליקציה שלכם תקרא לשירות הדואר, שרת הפיתוח ירשום ביומן את תוכן ההודעה. ההודעה לא תישלח בפועל.
אימות באמצעות DomainKeys Identified Mail (DKIM)
כששולחים אימייל, App Engine משתמש בתקן DomainKeys Identified Mail (DKIM) כדי לאמת את הדומיין. אם האפליקציה שולחת הודעות מכתובת אימייל ששייכת לדומיין של Google Workspace, App Engine יכול לחתום על האימיילים שהוא שולח בחתימה קריפטוגרפית. החתימה הזו מציינת שאימייל
שנראה כאילו הוא נשלח מ-emma@example.com באמת נשלח מ-example.com. הנמען יכול לבדוק את החתימה הזו. אם החתימה נכונה, הנמען יודע שהדומיין של השולח לא זויף.
כדי להפעיל אימות DKIM להודעות שנשלחות מכתובות אימייל ב-Google Workspace, צריך לפעול לפי ההוראות האלה במרכז העזרה של Google Workspace. שימו לב: יכולות לעבור עד 48 שעות עד שאימות DKIM יהיה פעיל בדומיין שלכם ב-Google Workspace.
צריך גם לוודא שהאפליקציה משתמשת בדומיין מותאם אישית ושהוא זהה לדומיין של Google Workspace. חשוב לדעת שאסור להשתמש בדומיינים של Google Workspace עם תת-דומיינים כמו subdomain.example.com.
מערכת App Engine תחתום על הודעות אימייל יוצאות מהאפליקציה אם כתובת השולח היא חלק מדומיין Google Workspace שמופעל בו DKIM. בנוסף, הפורמט של כתובת השולח צריך להיות כזה שחלק הדומיין של כתובת האימייל יכיל רק אותיות קטנות.
מכסות ומגבלות
כדי לראות את השימוש הנוכחי במכסה של האפליקציה, עוברים לדף פרטי המכסה במסוף Google Cloud .
כל בקשה לשירות הדואר נספרת במכסת הקריאות ל-Mail API. יש גם מכסות למספר ההודעות שאפשר לשלוח, למספר ההודעות שאדמינים יכולים לשלוח ולכמות הנתונים והקבצים שאפשר לשלוח. פרטים נוספים זמינים במאמר בנושא מכסות של דואר.
המכסה מתאפסת מדי יום. אם תחרגו מהמכסה היומית, תקבלו חריגה מהמכסה. אם אתם צריכים לשלוח יותר אימיילים מהמכסה המותרת, אתם יכולים להשתמש בספק אימייל מצד שלישי, כמו SendGrid או Mailgun.
בנוסף למכסות, המגבלות הבאות חלות על שירות Mail:
| הגבלה | סכום |
|---|---|
| הגודל המקסימלי של הודעות אימייל יוצאות, כולל קבצים מצורפים | 31.5MB |
| הגודל המקסימלי של הודעות אימייל נכנסות, כולל קבצים מצורפים | 31.5MB |
| הגודל המקסימלי של הודעה כשנמען הוא אדמין | 16KB |
| מספר השולחים המורשים המקסימלי | 50 |
המאמרים הבאים
- קוראים את ההנחיות לשליחת אימייל לרשימת תפוצה.
- איך שולחים אימיילים ומקבלים אימיילים באמצעות Mail API.
- אפשר לעיין ב
הפניית מודול
google.appengine.api.mail. - מידע נוסף על שיקולים להעברה של Mail API זמין במדריך Mail handlers.