יש שתי דרכים לשלוח אימייל באמצעות ממשק ה-API של Gmail:
- אפשר לשלוח אותו ישירות באמצעות
messages.send
. - אפשר לשלוח אותה מטיוטה באמצעות
drafts.send
.
הודעות אימייל נשלחות כמחרוזות מקודדות של base64url בתוך המאפיין raw
של
מקור הודעות. ברמה הכללית
תהליך העבודה לשליחת אימייל הוא:
- ליצור את תוכן האימייל בצורה נוחה ולקודד אותו base64url.
- יצירת משאב הודעה חדש והגדרת המאפיין
raw
שלו ל-base64url המחרוזת שיצרתם. - צריך להתקשר למספר
messages.send
. אם שולחים טיוטה, צריךdrafts.send
כדי לשלוח את ההודעה.
הפרטים של תהליך העבודה הזה יכולים להשתנות בהתאם ללקוח שנבחר ושפת התכנות.
יצירת הודעות
ל-Gmail API נדרשות הודעות אימייל עם MIME שתואמות ל- RFC 2822 וגם מקודדות כמחרוזות base64url. בשפות תכנות רבות יש ספריות או כלי עזר שמפשטים את תהליך היצירה והקידוד של MIME הודעות. דוגמאות הקוד הבאות ממחישות איך ליצור הודעת MIME באמצעות ספריות הלקוח של Google APIs בשפות שונות.
Java
אפשר ליצור הודעת אימייל בקלות בעזרת MimeMessage
המחלקה בחבילה javax.mail.internet
. הדוגמה הבאה ממחישה איך
כדי ליצור את הודעת האימייל, כולל הכותרות:
השלב הבא הוא לקודד את MimeMessage
, ליצור
Message
לאובייקט, ולהגדיר את מחרוזת ההודעה המקודדת של base64url כערך של
נכס raw
.
Python
דוגמת הקוד הבאה מדגימה יצירה של הודעת MIME, הקידוד
מחרוזת base64url, וההקצאה שלה לשדה raw
של Message
resource:
יצירת הודעות עם קבצים מצורפים
יצירת הודעה עם קובץ מצורף היא כמו יצירת הודעה אחרת, אבל התהליך של העלאת הקובץ בתור MIME רב-חלקי. ההודעה תלויה בשפת התכנות. את הקוד הבא דוגמאות שממחישות דרכים אפשריות ליצירת הודעת MIME מרובת חלקים עם קובץ מצורף.
Java
הדוגמה הבאה מראה איך ליצור הודעת MIME מרובת חלקים, בשלבי הקידוד וההקצאה זהים לאלו שמפורטים למעלה.
Python
בדומה לדוגמה הקודמת, דוגמה זו מטפלת גם בקידוד של
ומקצה את ההודעה לשדה raw
של Message
משאב.
שליחת הודעות
אחרי שיוצרים הודעה, אפשר לשלוח אותה
בקשת גוף הקריאה אל
messages.send
, כפי שמוצג
בדוגמאות הבאות.
Java
Python
אם אתם מנסים לשלוח תשובה ואתם רוצים שהאימייל יהיה שרשור, חשוב לוודא את הדברים הבאים:
- הכותרות
Subject
תואמות - הכותרות
References
ו-In-Reply-To
מופיעות אחרי תקן RFC 2822.
למידע על שליחת הודעה מטיוטה: יצירת טיוטות.