אפליקציות 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 SPF של הדומיין כדי לציין ש-Google היא מקור מהימן לאימיילים. הוראות להגדרה מופיעות במאמר רשומות 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.
בנוסף למכסות, המגבלות הבאות חלות על שירות האימייל:
| הגבלה | סכום |
|---|---|
| הגודל המקסימלי של הודעות אימייל יוצאות, כולל קבצים מצורפים | 31.5MB |
| הגודל המקסימלי של הודעות אימייל נכנסות, כולל קבצים מצורפים | 31.5MB |
| הגודל המקסימלי של הודעה כשנמען הוא אדמין | 16KB |
| מספר השולחים המורשים המקסימלי | 50 |
המאמרים הבאים
- קוראים את ההנחיות לשליחת אימייל לרשימת תפוצה.
- איך שולחים אימיילים ומקבלים אימיילים באמצעות Mail API.
- מידע נוסף זמין במאמרים בנושא
google.appengine.api.mailהפניית מודול . - מידע נוסף על שיקולים להעברה של Mail API זמין במדריך Mail handlers.