טריגרים של Apps Script גורמים לסקריפט מסוים פונקציה (פונקציית הטריגר) להפעלה בכל פעם שאירוע מסוים מתרחשת. רק אירועים מסוימים יכולים לגרום לטריגרים להפעיל, אפליקציית Google Workspace תומכת בקבוצה אחרת של אירועים.
כשטריגר מופעל, נוצר אובייקט אירוע. המבנה הזה של קובץ JSON מכילה פרטים על האירוע שהתרחש. המידע באירוע מבנה האובייקט מאורגן באופן שונה בהתאם לסוג הטריגר.
לאחר יצירת אובייקט האירוע, Apps Script מעביר אותו כפרמטר אל של הטריגר. פונקציית הטריגר היא פונקציית קריאה חוזרת שאתם צריכים לבצע את הפעולות המתאימות כדי להגיב אירוע. לדוגמה, תוסף Google Workspace שמרחיב את Gmail: אפשר הגדרת טריגר שיוצר ממשק כרטיס חדש כשהמשתמש פותח הודעה של שרשור. במקרה כזה, תטמיעו פונקציית קריאה חוזרת לפי הקשר כדי ליצור הכרטיסים שמרכיבים את ממשק המשתמש החדש שמבוססים על הנתונים שהועברו אובייקט של אירוע.
הדף הזה מספק הנחיות לשימוש בטריגרים Google Workspace פרויקטים נוספים.
טריגרים של מניפסט
בניגוד לתוספים לעורך, תוספים ל-Google Workspace כרגע אין אפשרות להשתמש ב-Apps Script בטריגרים פשוטים במקום זאת, הם משתמשים בטריגרים שמיועדים במיוחד תוספי Google Workspace: טריגרים של מניפסט.
טריגרים של מניפסט מוגדרים באופן מלא תוסף ל-Google Workspace מניפסט. דוגמאות לטריגרים של מניפסט: הבאים:
- טריגרים בדף הבית שיוצרים ומציגים את דף הבית של התוסף.
- טריגרים של פתיחה של אירוע ביומן שמציגים כרטיס חדש או מקבלים כרטיס חדש פעולות אחרות כשאירוע ביומן נפתח.
- טריגרים לעדכון של אירועים ביומן שמציגים כרטיס חדש או מקבלים כרטיס חדש פעולות אחרות כשמשתמש עורך ושומר אירוע ביומן.
- Drive onItemsנבחרו טריגרים שמציגים כרטיס חדש או מקבלים פעולות אחרות כשמשתמש בוחר קובץ או תיקייה אחת או יותר ב-Drive.
- טריגרים של כתיבה ידנית ב-Gmail שמציגים כרטיס של תוסף כאשר המשתמש פותח את התוסף בחלון הכתיבה של Gmail.
- טריגרים לפי הקשר ב-Gmail שמציגים כרטיס חדש או מתייחסים פעולות כשהמשתמש פותח הודעה ב-Gmail.
- טריגרים מסוג Editor onFileScopeGranted שמציגים כרטיס חדש כשמשתמשים
מתן הרשאה להיקף ההרשאות
drive.fileב-OAuth ב-Editor הנוכחי מהמסמך.
ברשימה שלמעלה, רק הטריגרים בדף הבית הם לא לפי הקשר. השאר טריגרים לפי הקשר. לעיון במניפסט למידע נוסף על הגדרות הטריגרים של מניפסטים.
נוסף לטריגרים של מניפסטים, Google Workspace תוספים יכולים גם להשתמש ב-Apps Script טריגרים שניתנים להתקנה.
הגבלות
בטריגרים של מניפסט יש הגבלות מסוימות על השימוש שלהם.
- הטריגרים האלה משמשים רק בפרויקטים עם תוספים ל-Google Workspace. שאין להם מטרה בשום אפליקציה אחרת.
- הם מוגדרים במניפסט של התוסף ולא בקוד שלו, ולכן אי אפשר
שימוש ב-Apps Script
Scriptהשירות כדי ליצור או לשנות את הטריגרים האלה. - בשלב זה, לטריגרים לפי הקשר ב-Gmail יכולים להיות רק קריטריונים של
unconditional. כלומר, טריגרים לפי הקשר מופעלים לכל הודעת אימייל, בלי קשר תוכן. - לכל תוסף יכול להיות רק מפעיל אחד מכל סוג, לכל משתמש ולכל מסמך.