Gmail API הוא API מסוג RESTful שאפשר להשתמש בו כדי לגשת לתיבות דואר ב-Gmail ולשלוח אימיילים. ברוב אפליקציות האינטרנט, Gmail API היא הבחירה הטובה ביותר לגישה מורשית לנתוני Gmail של משתמשים, והיא מתאימה לאפליקציות שונות, כמו:
- קריאה בלבד של חילוץ, יצירת אינדקס וגיבוי של דואר
- שליחת הודעות אוטומטית או באמצעות תוכנה
- העברת חשבונות אימייל
- סידור האימיילים, כולל סינון ומיון של ההודעות
- סטנדרטיזציה של חתימות אימייל בארגון
מונחים נפוצים
ריכזנו כאן רשימה של מונחים נפוצים שמופיעים ב-API הזה:
- המשתמש שנתן הרשאה לניהול שיחות והמשתמש שקיבל את ההרשאה
- משתמש שמעניק גישה הוא משתמש Gmail שנותן גישה לתיבת הדואר שלו למשתמש אחר באותו ארגון Google Workspace. המשתמש שמקבל את הגישה הוא הנציג. בעלי הגישה יכולים לקרוא, לשלוח ולמחוק הודעות, וגם לראות את אנשי הקשר בחשבון של מעניק ההרשאה ולהוסיף אליהם אנשי קשר חדשים. מידע נוסף זמין במאמר בנושא ניהול משתמשים עם הרשאה.
- Draft
- הודעה שלא נשלחה. אפשר להחליף הודעה שנכללת בטיוטה.
שליחת טיוטה מוחקת אותה באופן אוטומטי ויוצרת הודעה עם תווית המערכת
SENT. טיוטה מיוצגת על ידי המשאבdrafts. מידע נוסף זמין במאמר עבודה עם טיוטות. - מסננים
- כללים מתקדמים שהוגדרו לחשבון ומעריכים הודעות נכנסות בהתאם לקריטריונים ספציפיים (כמו השולח, הנושא או הגודל). כשמתקבלת הודעה שתואמת למסנן, המסננים מפעילים באופן אוטומטי פעולות כמו הוספה או הסרה של תוויות, או העברת האימייל לכתובת שצוינה. מידע נוסף זמין במאמר בנושא ניהול מסננים.
- כתובות להעברה
- כתובות אימייל ספציפיות ומאומתות שהוגדרו לקבל הודעות שמועברות אוטומטית מחשבון של משתמש. כדי להשתמש בכתובת בכלל העברה או במסנן, צריך לרשום אותה באופן רשמי ולאמת אותה כדי להוכיח בעלות. מידע נוסף זמין במאמר בנושא ניהול העברת הודעות.
- הוספת תווית
מנגנון לארגון הודעות ושרשורים. לדוגמה, אפשר ליצור את התווית 'מיסים' ולהחיל אותה על כל ההודעות והשרשורים שקשורים למיסים של המשתמש. מידע נוסף זמין במאמר בנושא ניהול תוויות.
יש שני סוגים של תוויות:
- תוויות מערכת
- תוויות שנוצרו באופן פנימי, כמו
INBOX,TRASHאוSPAM. אי אפשר למחוק או לשנות את התוויות האלה. עם זאת, אפשר להוסיף או להסיר חלק מתוויות המערכת, כמוINBOX, מהודעות ומשרשורים. - תוויות משתמשים
- תוויות שנוצרו על ידי משתמש. המשתמש או אפליקציה יכולים למחוק או לשנות את התוויות האלה. תווית משתמש מיוצגת על ידי המשאב
labels.
- Message
הודעת אימייל שמכילה את השולח, הנמענים, הנושא והגוף. אחרי שיוצרים הודעה, אי אפשר לשנות אותה. הודעה מיוצגת על ידי המשאב
messages.- התראות בדחיפה
מערכת התראות בצד השרת שמשולבת עם Google Cloud Pub/Sub. אפליקציות יכולות 'לצפות' בתיבת דואר, ו-Gmail API ישלח באופן אוטומטי ווּבְהוּקים או התראות בכל פעם שמתרחש שינוי (למשל, כשמגיעה הודעת אימייל חדשה), כך שהאפליקציה לא צריכה לבצע סקר שרתים באופן רציף כדי לקבל עדכונים. מידע נוסף זמין במאמר בנושא התראות Push.
- אישורי S/MIME
אישורים דיגיטליים שמועלים לכינויים ספציפיים של 'שליחה בשם' ומאפשרים למשתמש לשלוח אימיילים מוצפנים עם חתימה דיגיטלית, כדי להבטיח את אבטחת ההודעה ואת האותנטיות של השולח. מידע נוסף זמין במאמר בנושא ניהול אישורי S/MIME.
- כתובות אימייל חלופיות לשליחה
הן מייצגות את כתובות האימייל השונות שמהן החשבון מורשה לשלוח אימייל. לכל חשבון יש לפחות כתובת אימייל חלופית אחת שמייצגת את כתובת האימייל הראשית. כינויים תואמים לתכונה 'שליחת אימייל בשם' בממשק האינטרנט של Gmail, והם גם הבסיס להגדרת חתימות אימייל לכל כתובת. מידע נוסף זמין במאמר בנושא ניהול כתובות אימייל חלופיות.
- Thread
אוסף של הודעות קשורות שיוצרות שיחה. ביישום של לקוח אימייל, שרשור נוצר כשנמען אחד או יותר משיבים להודעה עם הודעה משלהם. מידע נוסף מופיע במאמר בנושא ניהול שרשורים.
נושאים קשורים
כדי לקבל מידע על פיתוח באמצעות ממשקי API של Google Workspace, כולל טיפול באימות ובמתן הרשאה, אפשר לעיין במאמר פיתוח ב-Google Workspace.
כדי ללמוד איך להגדיר ולהריץ אפליקציה של Gmail API, אפשר לקרוא את המדריכים למתחילים.