טריגרים פשוטים וגם
טריגרים שניתנים להתקנה מאפשרים ל-Apps Script
להריץ פונקציה באופן אוטומטי אם מתרחש אירוע מסוים. כשטריגר מופעל,
Apps Script מעביר את הפונקציה של אובייקט אירוע כארגומנט, שנקרא בדרך כלל
e
אובייקט האירוע מכיל מידע על ההקשר שגרם
להפעיל את הטריגר. למשל, הקוד לדוגמה הבא מראה תג onEdit(e)
פשוט.
טריגר לסקריפט של Google Sheets שמשתמש באובייקט האירוע כדי לקבוע איזה
התא נערך.
function onEdit(e){
// Set a comment on the edited cell to indicate when it was changed.
var range = e.range;
range.setNote('Last modified: ' + new Date());
}
הדף הזה מפרט את השדות באובייקט האירוע עבור סוגים שונים של טריגרים.
אירועים ב-Google Sheets
הטריגרים השונים שספציפיים ל-Google Sheets מאפשרים לסקריפטים להגיב לפקודה של המשתמש בגיליון אלקטרוני.
פתיחה(פשוטה וניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum LIMITED |
source |
Spreadsheet |
triggerUid |
מזהה הטריגר שיצר את האירוע הזה (רק טריגרים שניתנים להתקנה). 4034124084959907503 |
user |
אובייקט amin@example.com |
שינוי(ניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum FULL |
changeType |
סוג השינוי ( INSERT_ROW |
source |
Spreadsheet |
triggerUid |
המזהה של הטריגר שהפיק את האירוע הזה. 4034124084959907503 |
user |
אובייקט amin@example.com |
עריכה(פשוטה וניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum LIMITED |
oldValue |
הערך של התא לפני העריכה, אם יש כזה. האפשרות הזו זמינה רק אם נערכו הוא תא יחיד. ההגדרה לא תהיה מוגדרת אם לתא לא היה תוכן. 1234 |
range |
אובייקט Range |
source |
Spreadsheet |
triggerUid |
מזהה הטריגר שיצר את האירוע הזה (רק טריגרים שניתנים להתקנה). 4034124084959907503 |
user |
אובייקט amin@example.com |
value |
הערך החדש של התא אחרי העריכה. האפשרות הזו זמינה רק אם הטווח הערוך הוא בתא יחיד. 10 |
שליחת טופס(ניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum FULL |
namedValues |
אובייקט שמכיל את השמות והערכים של השאלות שנשלחו משליחת הטופס. { 'First Name': ['Jane'], 'Timestamp': ['6/7/2015 20:54:13'], 'Last Name': ['Doe'] } |
range |
אובייקט Range |
triggerUid |
המזהה של הטריגר שהפיק את האירוע הזה. 4034124084959907503 |
values |
מערך עם ערכים באותו סדר שבו הם מופיעים בגיליון האלקטרוני. ['2015/05/04 15:00', 'amin@example.com', 'Bob', '27', 'Bill', '28', 'Susan', '25'] |
אירועים ב-Google Docs
טריגרים מאפשרים ל-Google Docs להגיב כשמשתמש פותח מסמך.
פתיחה(פשוטה וניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum LIMITED |
source |
אובייקט Document |
triggerUid |
מזהה הטריגר שיצר את האירוע הזה (רק טריגרים שניתנים להתקנה). 4034124084959907503 |
user |
אובייקט amin@example.com |
אירועים ב-Google Slides
טריגרים מאפשרים ל-Google Slides להגיב כשמשתמש פותח מצגת.
פתיחה(פשוט) |
|
---|---|
authMode |
ערך מ-enum LIMITED |
source |
אובייקט Presentation |
user |
אובייקט amin@example.com |
אירועים ב-Google Forms
הטריגרים הספציפיים ל-Google Forms מאפשרים לסקריפטים להגיב כשמשתמש עורך טופס או שולח תשובה.
פתיחה* (פשוט וניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum LIMITED |
source |
אובייקט Form |
triggerUid |
מזהה הטריגר שיצר את האירוע הזה (רק טריגרים שניתנים להתקנה). 4034124084959907503 |
user |
אובייקט amin@example.com |
* האירוע הזה לא מתרחש כשמשתמש פותח טופס כדי להשיב, אלא כשעורך פותח את הטופס כדי לשנות אותו.
שליחת טופס(ניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-enum FULL |
response |
אובייקט FormResponse |
source |
אובייקט Form |
triggerUid |
המזהה של הטריגר שהפיק את האירוע הזה. 4034124084959907503 |
אירועים ביומן Google
לוח השנה מופעל כשאירועים ביומן של משתמש מתעדכנים (נוצרים, נערך או נמחק).
הטריגרים האלה לא מציינים איזה אירוע השתנה או איך הוא השתנה. במקום זאת, הם מציינים שהקוד צריך לבצע פעולת סנכרון מצטברת. כדי לראות את השינויים האחרונים ביומן. לתיאור מלא בתהליך הזה אפשר לקרוא מדריך לסנכרון משאבים לממשק ה-API של יומן Google.
כדי לסנכרן עם יומן Google ב-Apps Script, מבצעים את השלבים הבאים:
- מפעילים את השירות המתקדם של יומן Google עבור בפרויקט הסקריפט. התכונה שירות יומן Google לא מספיק עבור תהליך העבודה הזה.
- לקבוע אילו יומנים יסונכרנו. לגבי כל יומן כזה, לבצע סנכרון ראשוני באמצעות השירות המתקדם של יומן Google המתודה Events.list().
- התוצאה של הסנכרון הראשוני תחזיר את הערך
nextSyncToken
עבור היומן הזה. יש לשמור את האסימון הזה לשימוש במועד מאוחר יותר. - כאשר הטריגר של Apps Script
EventUpdated
מופעל כדי לציין יומן שינוי אירוע, ביצוע סנכרון מצטבר של היומן המושפע באמצעות קובץ ה-nextSyncToken
המאוחסן. הדבר בעיקרון עוד Events.list() אבל הוספת הערךnextSyncToken
מגבילה את התגובה אירועים שהשתנו מאז הסנכרון האחרון. - לבדוק את התגובה של הסנכרון כדי לגלות אילו אירועים עודכנו שהקוד שלכם יגיב בצורה תקינה. לדוגמה, אפשר לתעד את השינוי, לעדכן גיליון אלקטרוני, לשלוח הודעות אימייל או לבצע פעולות אחרות.
- לעדכן את
nextSyncToken
שאחסנתם ביומן הזה עם היומן שהוחזר לפי בקשת הסנכרון המצטברת. הפעולה הזו מאלצת את פעולת הסנכרון הבאה רק את השינויים העדכניים ביותר.
EventUpdated(ניתנת להתקנה) |
|
---|---|
authMode |
ערך מ-
FULL |
calendarId |
מזהה המחרוזת של היומן שבו אירע עדכון האירוע. susan@example.com |
triggerUid |
המזהה של הטריגר שהפיק את האירוע הזה. 4034124084959907503 |
אירועים עם תוספים ל-Google Workspace
הטריגר onInstall()
פועל
באופן אוטומטי כשמשתמש מתקין תוסף.
התקנה(פשוט) |
|
---|---|
authMode |
ערך מ-enum FULL |
אירועים באפליקציית Google Chat
מידע על אובייקטים של אירועים ב-Google Chat לקבל אינטראקציות עם אפליקציית Google Chat ולהגיב עליהן.
אירועים מבוססי-זמן
טריגרים שמבוססים על זמן (נקראים גם טריגרים בשעון) מאפשרים לסקריפטים לפעול בשעה מסוימת למרווח זמן קבוע.
מבוסס זמן (ניתן להתקנה) | |
---|---|
authMode |
ערך מ-enum FULL |
day-of-month |
בין מאחר ששם הנכס הזה מכיל מקפים, צריך לגשת אליו דרך
31 |
day-of-week |
בין מאחר ששם הנכס הזה מכיל מקפים, צריך לגשת אליו דרך
7 |
hour |
בין 23 |
minute |
בין 59 |
month |
בין 12 |
second |
בין 59 |
timezone |
אזור הזמן. UTC |
triggerUid |
המזהה של הטריגר שהפיק את האירוע הזה. 4034124084959907503 |
week-of-year |
בין מאחר ששם הנכס הזה מכיל מקפים, צריך לגשת אליו דרך
52 |
year |
השנה. 2015 |