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, אפשר לקרוא את המדריכים למתחילים.