סקירה כללית על Gmail API

‫Gmail API הוא RESTful API שמאפשר לכם לגשת לתיבות דואר ב-Gmail ולשלוח אימיילים. ברוב אפליקציות האינטרנט, Gmail API הוא הבחירה הטובה ביותר לגישה מורשית לנתוני Gmail של משתמש, והוא מתאים למגוון אפליקציות, כמו:

  • חילוץ, יצירת אינדקס וגיבוי של אימיילים עם הרשאת קריאה בלבד
  • שליחת הודעות אוטומטית או מתוכנתת
  • העברת חשבונות אימייל
  • ארגון האימיילים, כולל סינון ומיון של הודעות
  • סטנדרטיזציה של חתימות באימייל בארגון

מונחים נפוצים

ריכזנו כאן רשימה של מונחים נפוצים שמופיעים ב-API הזה:

המשתמש שנתן הרשאה לניהול שיחות והמשתמש שקיבל את ההרשאה
משתמש שמעניק גישה הוא משתמש Gmail שמעניק גישה לתיבת הדואר למשתמש אחר באותו ארגון Google Workspace. המשתמש שמקבל את הגישה הוא הנציג. בעלי הגישה יכולים לקרוא, לשלוח ולמחוק הודעות, וגם לראות את אנשי הקשר בחשבון של מי שהעניק להם את הגישה ולהוסיף אליהם אנשי קשר חדשים. מידע נוסף זמין במאמר ניהול הרשאות גישה.
Draft
הודעה שלא נשלחה. אפשר להחליף את ההודעה שבטיוטה. שליחת טיוטה מוחקת אותה באופן אוטומטי ויוצרת הודעה עם תווית המערכת SENT. מקור המידע drafts מייצג טיוטה. מידע נוסף זמין במאמר איך עובדים עם טיוטות.
מסננים
כללים מתקדמים שהוגדרו לחשבון ומעריכים הודעות נכנסות לפי קריטריונים ספציפיים (כמו השולח, הנושא או הגודל). כשמתקבלת הודעה שתואמת למסנן, המסננים מפעילים באופן אוטומטי פעולות כמו הוספה או הסרה של תוויות, או העברת האימייל לכתובת שצוינה. מידע נוסף זמין במאמר בנושא ניהול מסננים.
כתובות להעברה
כתובות אימייל ספציפיות ומאומתות שהוגדרו לקבל הודעות שמועברות אוטומטית מחשבון של משתמש. כדי להשתמש בכתובת בכלל העברה או במסנן, צריך לרשום אותה ולאמת אותה כדי להוכיח בעלות. מידע נוסף זמין במאמר בנושא ניהול העברת הודעות.
הוספת תווית

מנגנון לארגון הודעות ושרשורים. לדוגמה, אתם יכולים ליצור את התווית 'מיסים' ולהחיל אותה על כל ההודעות והשרשורים שקשורים למיסים. מידע נוסף זמין במאמר בנושא ניהול תוויות.

יש שני סוגים של תוויות:

תוויות מערכת
תוויות שנוצרו באופן פנימי, כמו INBOX,‏ TRASH או SPAM. אי אפשר למחוק או לשנות את התוויות האלה. עם זאת, אפשר להוסיף או להסיר חלק מתוויות המערכת, כמו INBOX, להודעות ולשרשורים.
תוויות משתמשים
תוויות שנוצרו על ידי משתמש. משתמש או אפליקציה יכולים למחוק או לשנות את התוויות האלה. ‫labels מייצג תווית משתמש.
Message

הודעת אימייל שמכילה את השולח, הנמענים, הנושא והתוכן. אחרי שיוצרים הודעה, אי אפשר לשנות אותה. ‫The messages resource represents a message.

התראות

מערכת התראות בצד השרת שמשולבת עם Google Cloud Pub/Sub. אפליקציות יכולות 'לצפות' בתיבת דואר, ו-Gmail API שולח וווב-הוקים או התראות אוטומטיות בכל פעם שמתרחש שינוי (למשל, כשמגיע אימייל חדש). כך האפליקציה לא צריכה לשלוח לשרת בקשות חוזרות ונשנות כדי לקבל עדכונים. מידע נוסף זמין במאמר בנושא התראות Push.

אישורי S/MIME

אישורים דיגיטליים שהועלו לאימיילים חלופיים ספציפיים של 'שליחה בשם'. האישורים האלה מאפשרים לכם לשלוח אימיילים מוצפנים וחתומים דיגיטלית, וכך לוודא שההודעות מאובטחות והשולחים הם אותנטיים. מידע נוסף זמין במאמר בנושא ניהול אישורי S/MIME.

כתובות אימייל חלופיות לשליחה

הכתובות האלה מייצגות את כתובות האימייל השונות שמהן החשבון מורשה לשלוח אימייל. לכל חשבון יש לפחות כינוי אחד שמייצג את כתובת האימייל הראשית. כתובות אימייל חלופיות תואמות לתכונה 'שליחת אימייל בשם' בממשק האינטרנט של Gmail, והן גם הבסיס להגדרת חתימות אימייל לכל כתובת. מידע נוסף זמין במאמר בנושא ניהול כתובות אימייל חלופיות.

Thread

קבוצה של הודעות קשורות שיוצרות שיחה. בתוכנת אימייל, שרשור נוצר כשנמען אחד או יותר משיבים להודעה עם הודעה משלהם. מידע נוסף מופיע במאמר בנושא ניהול שרשורים.

  • מידע על פיתוח באמצעות ממשקי API של Google Workspace, כולל טיפול באימות ובמתן הרשאות, זמין במאמר פיתוח ב-Google Workspace.

  • כדי ללמוד איך להגדיר ולהריץ אפליקציה ל-Gmail API, אפשר לקרוא את המדריכים למתחילים.