טריגרים לתוספים ל-Google Workspace

טריגרים של Apps Script גורמים להרצה של פונקציית סקריפט ספציפית (פונקציית הטריגר) בכל פעם שמתרחש אירוע ספציפי. רק אירועים מסוימים יכולים להפעיל טריגרים, וכל אפליקציה של Google Workspace תומכת בקבוצה שונה של אירועים.

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

אחרי שאובייקט האירוע נוצר, Apps Script מעביר אותו כפרמטר לפונקציית הטריגר. פונקציית הטריגר היא פונקציית קריאה חוזרת שאתם צריכים להטמיע בעצמכם, כדי לבצע את הפעולות המתאימות בתגובה לאירוע. לדוגמה, בתוסף ל-Google Workspace שמרחיב את Gmail, אפשר להגדיר טריגר שיוצר ממשק כרטיס חדש כשהמשתמש פותח שרשור הודעות. במקרה כזה, מטמיעים פונקציית קריאה חוזרת תלוית-הקשר כדי ליצור את הכרטיסים שמרכיבים את ממשק המשתמש החדש באמצעות הנתונים שמועברים באובייקט האירוע.

בדף הזה מפורטות הנחיות לשימוש בטריגרים בפרויקטים של תוספים ל-Google Workspace.

טריגרים של מניפסט

בניגוד לתוספים של Editor, תוספים ל-Google Workspace לא יכולים להשתמש בטריגרים פשוטים של Google Apps Script. במקום זאת, הם משתמשים בטריגרים שנועדו במיוחד לתוספים של Google Workspace: טריגרים של קובץ המניפסט.

טריגרים של קובץ מניפסט מוגדרים במניפסט של התוסף ל-Google Workspace. דוגמאות:

  • טריגרים בדף הבית שיוצרים ומציגים את דף הבית של התוסף.
  • טריגרים של פתיחת אירוע ביומן Google שמציגים כרטיס חדש או מבצעים פעולות אחרות כשפותחים אירוע.
  • טריגרים של עדכון אירוע ביומן שמציגים כרטיס חדש או מבצעים פעולות אחרות כשמשתמש עורך אירוע ושומר אותו.
  • הטריגרים onItemsSelected של Google Drive מציגים כרטיס חדש או מבצעים פעולות אחרות כשמשתמש בוחר קבצים או תיקיות.
  • טריגרים של כתיבת אימייל ב-Gmail שמציגים כרטיס של תוסף כשהמשתמש פותח את התוסף בחלון הכתיבה.
  • טריגרים הקשריים של Gmail שמציגים כרטיס חדש או מבצעים פעולות אחרות כשהמשתמש פותח הודעה.
  • Editor onFileScopeGranted triggers that display a new card when users grant authorization for the drive.file OAuth scope in the document.

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

בנוסף לגורמים מפעילים של מניפסט, תוספים ל-Google Workspace יכולים להשתמש בגורמים מפעילים שניתנים להתקנה של Apps Script.

הגבלות

יש הגבלות מסוימות על השימוש בטריגרים של מניפסט.

  • הטריגרים האלה משמשים רק בפרויקטים של תוספים ל-Google Workspace.
  • מכיוון שהם מוגדרים במניפסט של התוסף ולא בקוד, אי אפשר להשתמש בשירות Script של Apps Script כדי ליצור או לשנות אותם.
  • טריגרים הקשריים של Gmail מופעלים לכל הודעת אימייל, ללא קשר לתוכן.
  • לכל תוסף יכול להיות רק טריגר אחד מכל סוג, לכל משתמש ולכל מסמך.