טריגרים של Apps Script גורמים להרצה של פונקציית סקריפט ספציפית (פונקציית הטריגר) בכל פעם שמתרחש אירוע ספציפי. רק אירועים מסוימים יכולים להפעיל טריגרים, וכל אפליקציית Google Workspace תומכת בקבוצה שונה של אירועים.
כשמופעל טריגר, נוצר אובייקט אירוע. מבנה ה-JSON הזה מכיל פרטים על האירוע שהתרחש. המידע במבנה של אובייקט האירוע מאורגן בצורה שונה בהתאם לסוג הטריגר.
אחרי שיוצרים את אובייקט האירוע, Apps Script מעביר אותו כפרמטר לפונקציית הגורם המפעיל. פונקציית הטריגר היא פונקציית קריאה חוזרת שאתם צריכים להטמיע בעצמכם, כדי לבצע את הפעולות המתאימות בתגובה לאירוע. לדוגמה, בתוסף ל-Google Workspace שמרחיב את Gmail, אפשר להגדיר טריגר שיוצר ממשק כרטיס חדש כשהמשתמש פותח שרשור הודעות. במקרה כזה, מטמיעים פונקציית קריאה חוזרת תלוית-הקשר כדי ליצור את הכרטיסים שמרכיבים את ממשק המשתמש החדש באמצעות הנתונים שמועברים באובייקט האירוע.
בדף הזה מפורטות הנחיות לשימוש בטריגרים בפרויקטים של תוספים ל-Google Workspace.
טריגרים של מניפסט
בניגוד לתוספים של Editor, תוספים ל-Google Workspace לא יכולים להשתמש כרגע בטריגרים פשוטים של Apps Script. במקום זאת, הם משתמשים בטריגרים שנועדו במיוחד לתוספים ל-Google Workspace: טריגרים של קובץ המניפסט.
טריגרים של מניפסט מוגדרים באופן מלא במניפסט של תוסף Google Workspace. דוגמאות לטריגרים של מניפסט:
- טריגרים של דף הבית שיוצרים ומציגים את דף הבית של התוסף.
- טריגרים של פתיחת אירוע ביומן שמציגים כרטיס חדש או מבצעים פעולות אחרות כשפותחים אירוע ביומן.
- טריגרים של עדכון אירוע ביומן שמציגים כרטיס חדש או מבצעים פעולות אחרות כשמשתמש עורך אירוע ביומן ושומר אותו.
- טריגרים של Drive onItemsSelected שמציגים כרטיס חדש או מבצעים פעולות אחרות כשמשתמש בוחר קובץ אחד או יותר או תיקיות ב-Drive.
- טריגרים של כתיבת אימייל ב-Gmail שמציגים כרטיס של תוסף כשהמשתמש פותח את התוסף בחלון של כתיבת אימייל ב-Gmail.
- טריגרים הקשריים של Gmail שמציגים כרטיס חדש או מבצעים פעולות אחרות כשהמשתמש פותח הודעה ב-Gmail.
- Editor onFileScopeGranted triggers that display a new card when users
grant authorization for the
drive.fileOAuth scope in the current Editor document.
ברשימה שלמעלה, רק הטריגרים של דף הבית הם לא קונטקסטואליים. כל השאר הם טריגרים קונטקסטואליים. מידע נוסף על הגדרות טריגר במניפסט זמין במאמר בנושא מניפסט.
בנוסף לגורמים מפעילים של מניפסט, תוספים של Google Workspace יכולים להשתמש גם בגורמים מפעילים שניתנים להתקנה של Apps Script.
הגבלות
יש הגבלות מסוימות על השימוש בטריגרים של מניפסט.
- הטריגרים האלה משמשים רק בפרויקטים של תוספים ל-Google Workspace, ואין להם שימוש באפליקציות אחרות.
- הטריגרים האלה מוגדרים במניפסט של התוסף ולא בקוד שלו, ולכן אי אפשר להשתמש בשירות
Scriptשל Apps Script כדי ליצור או לשנות אותם. - כרגע, טריגרים הקשריים ב-Gmail יכולים לכלול רק קריטריון
unconditional. כלומר, טריגרים לפי הקשר מופעלים לכל הודעת אימייל, ללא קשר לתוכן. - לכל תוסף יכול להיות רק טריגר אחד מכל סוג, לכל משתמש ולכל מסמך.