Script Service

השירות הזה מספק גישה לטריגרים של סקריפטים ולפרסום סקריפטים.

שיעורים

שם	תיאור קצר
`AuthMode`	ספירה שמזהה אילו קטגוריות של שירותים מורשים יכולות לפעול ב-Apps Script באמצעות פונקציה שהופעלה על ידי טריגר.
`AuthorizationInfo`	אובייקט שבודק אם המשתמש העניק הרשאה להיקפי ההרשאות הנדרשים של הסקריפט.
`AuthorizationStatus`	ספירה שמציינת את סטטוס ההרשאה של סקריפט.
`CalendarTriggerBuilder`	‫Builder לטריגרים של היומן.
`ClockTriggerBuilder`	‫Builder להפעלות חוזרות לפי שעון.
`DocumentTriggerBuilder`	‫builder לטריגרים של מסמכים.
`EventType`	ספירה שמציינת את סוג האירוע שהופעל.
`FormTriggerBuilder`	כלי ליצירת טריגרים לטפסים.
`InstallationSource`	ספירה שמציינת איך הסקריפט הותקן כתוסף עבור המשתמש הנוכחי.
`ScriptApp`	גישה לפרסום סקריפטים ולטריגרים וביצוע פעולות בהם.
`Service`	גישה לפרסום סקריפטים וביצוע שינויים בו.
`SpreadsheetTriggerBuilder`	‫Builder לטריגרים של גיליונות אלקטרוניים.
`StateTokenBuilder`	מאפשרת לסקריפטים ליצור אסימוני מצב שאפשר להשתמש בהם בממשקי API של קריאה חוזרת (כמו תהליכי OAuth).
`Trigger`	טריגר לסקריפט.
`TriggerBuilder`	‫builder גנרי לטריגרים של סקריפטים.
`TriggerSource`	ספירה שמציינת את המקור של האירוע שגורם להפעלת הטריגר.

`AuthMode`

מאפיינים

נכס	סוג	תיאור
`NONE`	`Enum`	מצב שלא מאפשר גישה לשירותים שנדרשת הרשאה כדי להשתמש בהם.
`CUSTOM_FUNCTION`	`Enum`	מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים לשימוש בפונקציות מותאמות אישית של גיליונות אלקטרוניים.
`LIMITED`	`Enum`	מצב שמאפשר גישה לקבוצת משנה מוגבלת של שירותים.
`FULL`	`Enum`	מצב שמאפשר גישה לכל השירותים שנדרש להם אישור.

`AuthorizationInfo`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`getAuthorizationStatus()`	`AuthorizationStatus`	מקבל ערך שמציין אם המשתמש צריך לאשר לסקריפט הזה להשתמש בשירות אחד או יותר (לדוגמה, `ScriptApp.AuthorizationStatus.REQUIRED`).
`getAuthorizationUrl()`	`String\|null`	מקבל את כתובת ה-URL לאישור שאפשר להשתמש בה כדי להעניק גישה לסקריפט.
`getAuthorizedScopes()`	`String[]\|null`	מקבל רשימה של היקפי הרשאות מורשים לסקריפט.

`AuthorizationStatus`

מאפיינים

נכס	סוג	תיאור
`REQUIRED`	`Enum`	המשתמש צריך לתת הרשאה לסקריפט הזה להשתמש בשירות אחד או יותר.
`NOT_REQUIRED`	`Enum`	המשתמש העניק לסקריפט הזה את כל ההרשאות שהוא דורש כרגע.

`CalendarTriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`create()`	`Trigger`	יוצר את הטריגר ומחזיר אותו.
`onEventUpdated()`	`CalendarTriggerBuilder`	מציין טריגר שמופעל כשיוצרים, מעדכנים או מוחקים פריט ביומן.

`ClockTriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`after(durationMilliseconds)`	`ClockTriggerBuilder`	מציין את משך הזמן המינימלי (באלפיות השנייה) אחרי השעה הנוכחית שבה הטריגר יפעל.
`at(date)`	`ClockTriggerBuilder`	מציינת מתי הטריגר מופעל.
`atDate(year, month, day)`	`ClockTriggerBuilder`	ההגדרה הזו מציינת שהטריגר מופעל בתאריך שצוין, כברירת מחדל בסביבות חצות (‎+/- 15 דקות).
`atHour(hour)`	`ClockTriggerBuilder`	מציינים את השעה שבה הטריגר מופעל.
`create()`	`Trigger`	יוצר את הטריגר.
`everyDays(n)`	`ClockTriggerBuilder`	ההגדרה הזו מציינת שהטריגר יופעל כל `n` ימים.
`everyHours(n)`	`ClockTriggerBuilder`	מציין שהטריגר יופעל כל `n` שעות.
`everyMinutes(n)`	`ClockTriggerBuilder`	מציין שהטריגר יפעל כל `n` דקות.
`everyWeeks(n)`	`ClockTriggerBuilder`	מציין שהמפעיל יפעל כל `n` שבועות.
`inTimezone(timezone)`	`ClockTriggerBuilder`	מציין את אזור הזמן של התאריכים או השעה שצוינו, שבהם הטריגר יפעל.
`nearMinute(minute)`	`ClockTriggerBuilder`	מציינת את הדקה שבה הטריגר יפעל (בתוספת או בניכוי של 15 דקות).
`onMonthDay(day)`	`ClockTriggerBuilder`	מציין את התאריך בחודש שבו הטריגר מופעל.
`onWeekDay(day)`	`ClockTriggerBuilder`	מציין את היום בשבוע שבו הטריגר יפעל.

`DocumentTriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`create()`	`Trigger`	יוצר ומחזיר את הטריגר החדש.
`onOpen()`	`DocumentTriggerBuilder`	מציין טריגר שמופעל כשפותחים את המסמך.

`EventType`

מאפיינים

נכס	סוג	תיאור
`CLOCK`	`Enum`	הטריגר מופעל ברגע שהאירוע שמבוסס על זמן מגיע לזמן ספציפי.
`ON_OPEN`	`Enum`	הטריגר מופעל ברגע שהמשתמש פותח את הקובץ ב-Google Docs,‏ Sheets או Forms.
`ON_EDIT`	`Enum`	הטריגר מופעל ברגע שהמשתמש עורך את הקובץ ב-Google Sheets (לדוגמה, על ידי הזנת ערך חדש בתא, שנספר כעריכה ולא כשינוי).
`ON_FORM_SUBMIT`	`Enum`	הטריגר מופעל אחרי שהמשתמש מגיב לטופס ב-Google Forms.
`ON_CHANGE`	`Enum`	הטריגר מופעל ברגע שהמשתמש משנה את הקובץ ב-Google Sheets (לדוגמה, על ידי הוספת שורה, שנחשבת לשינוי ולא לעריכה).
`ON_EVENT_UPDATED`	`Enum`	הטריגר מופעל כשאירוע נוצר, מעודכן או נמחק ביומן Google שצוין.

`FormTriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`create()`	`Trigger`	יוצר ומחזיר את הטריגר החדש.
`onFormSubmit()`	`FormTriggerBuilder`	מציין טריגר שמופעל כשנשלחת תשובה לטופס.
`onOpen()`	`FormTriggerBuilder`	מציינים טריגר שמופעל כשפותחים את תצוגת העריכה של הטופס.

`InstallationSource`

מאפיינים

נכס	סוג	תיאור
`APPS_MARKETPLACE_DOMAIN_ADD_ON`	`Enum`	התוסף הותקן על ידי האדמין בדומיין של המשתמש.
`NONE`	`Enum`	הסקריפט לא פועל כתוסף.
`WEB_STORE_ADD_ON`	`Enum`	התוסף הותקן על ידי המשתמש מחנות האינטרנט של Chrome.

`ScriptApp`

מאפיינים

נכס	סוג	תיאור
`AuthMode`	`AuthMode`	ספירה שמזהה אילו קטגוריות של שירותים מורשים יכולות לפעול ב-Apps Script באמצעות פונקציה מופעלת.
`AuthorizationStatus`	`AuthorizationStatus`	ספירה שמציינת את סטטוס ההרשאה של סקריפט.
`EventType`	`EventType`	ספירה שמציינת את סוג האירוע שהופעל.
`InstallationSource`	`InstallationSource`	ספירה שמציינת איך הסקריפט הותקן אצל המשתמש כתוסף.
`TriggerSource`	`TriggerSource`	ספירה שמציינת את המקור של האירוע שגורם להפעלת הטריגר.
`WeekDay`	`Weekday`	ספירה שמייצגת את ימי השבוע.

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`deleteTrigger(trigger)`	`void`	הפונקציה מסירה את הטריגר שצוין כדי שהוא לא יפעל יותר.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	מקבל אובייקט שבודק אם המשתמש העניק הרשאה לכל הדרישות של הסקריפט.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	מקבלים אובייקט שבודק אם המשתמש העניק הרשאה להיקפי ההרשאות המבוקשים.
`getIdentityToken()`	`String\|null`	מקבל אסימון זהות של OpenID Connect בשביל המשתמש האפקטיבי, אם הוענק היקף ההרשאות `openid`.
`getInstallationSource()`	`InstallationSource`	הפונקציה מחזירה ערך enum שמציין איך התסריט הותקן כתוסף עבור המשתמש הנוכחי (לדוגמה, אם המשתמש התקין אותו באופן אישי דרך חנות האינטרנט של Chrome, או אם אדמין בדומיין התקין אותו עבור כל המשתמשים).
`getOAuthToken()`	`String`	מקבל את אסימון הגישה מסוג OAuth 2.0 עבור המשתמש בפועל.
`getProjectTriggers()`	`Trigger[]`	מחזירה את כל הגורמים המפעילים שניתן להתקין שמשויכים לפרויקט הנוכחי ולמשתמש הנוכחי.
`getScriptId()`	`String`	מחזירה את המזהה הייחודי של פרויקט הסקריפט.
`getService()`	`Service`	מחזירה אובייקט שמשמש לשליטה בפרסום הסקריפט כאפליקציית אינטרנט.
`getUserTriggers(document)`	`Trigger[]`	הפונקציה מחזירה את כל הטריגרים שניתן להתקין שהמשתמש הזה הוא הבעלים שלהם במסמך הנתון, רק עבור הסקריפט או התוסף הזה.
`getUserTriggers(form)`	`Trigger[]`	מחזירה את כל הטריגרים שניתן להתקין שנמצאים בבעלות המשתמש בטופס הנתון, רק עבור הסקריפט או התוסף הזה.
`getUserTriggers(spreadsheet)`	`Trigger[]`	הפונקציה מחזירה את כל הטריגרים שאפשר להתקין שנמצאים בבעלות המשתמש בגיליון האלקטרוני הנתון, רק עבור הסקריפט או התוסף הזה.
`invalidateAuth()`	`void`	הפונקציה מבטלת את ההרשאה שיש למשתמש בפועל להריץ את הסקריפט הנוכחי.
`newStateToken()`	`StateTokenBuilder`	יוצר builder לאסימון מצב שאפשר להשתמש בו ב-API של קריאה חוזרת (callback) (כמו תהליך OAuth).
`newTrigger(functionName)`	`TriggerBuilder`	מתחיל את התהליך של יצירת טריגר שאפשר להתקין, וכשהוא מופעל הוא קורא לפונקציה נתונה.
`requireAllScopes(authMode)`	`void`	בודק אם המשתמש העניק הסכמה לכל ההיקפים שהסקריפט מבקש.
`requireScopes(authMode, oAuthScopes)`	`void`	האימות קובע אם המשתמש העניק הסכמה להיקפי ההרשאות המבוקשים.

`Service`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`getUrl()`	`String`	הפונקציה מחזירה את כתובת ה-URL של אפליקציית האינטרנט, אם היא נפרסה. אחרת, היא מחזירה `null`.
`isEnabled()`	`Boolean`	הפונקציה מחזירה את הערך `true` אם אפשר לגשת לסקריפט כאפליקציית אינטרנט.

`SpreadsheetTriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`create()`	`Trigger`	יוצר את הטריגר ומחזיר אותו.
`onChange()`	`SpreadsheetTriggerBuilder`	מציינים טריגר שמופעל כשתוכן הגיליון האלקטרוני או המבנה שלו משתנים.
`onEdit()`	`SpreadsheetTriggerBuilder`	מציין טריגר שמופעל כשעורכים את הגיליון האלקטרוני.
`onFormSubmit()`	`SpreadsheetTriggerBuilder`	מציין טריגר שמופעל כשנשלח טופס לגיליון האלקטרוני.
`onOpen()`	`SpreadsheetTriggerBuilder`	מציין טריגר שמופעל כשפותחים את הגיליון האלקטרוני.

`StateTokenBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`createToken()`	`String`	יוצרת ייצוג מחרוזת מוצפנת של אסימון המצב.
`withArgument(name, value)`	`StateTokenBuilder`	הוספת ארגומנט לטוקן.
`withMethod(method)`	`StateTokenBuilder`	מגדיר פונקציית קריאה חוזרת.
`withTimeout(seconds)`	`StateTokenBuilder`	הגדרת משך הזמן (בשניות) שבו האסימון תקף.

`Trigger`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`getEventType()`	`EventType`	מחזירה את סוג האירוע שהטריגר מופעל בו.
`getHandlerFunction()`	`String`	מחזירה את הפונקציה שמופעלת כשהטריגר מופעל.
`getTriggerSource()`	`TriggerSource`	הפונקציה מחזירה את מקור האירועים שגורמים להפעלת הטריגר.
`getTriggerSourceId()`	`String`	מחזירה את המזהה הספציפי למקור.
`getUniqueId()`	`String`	הפונקציה מחזירה מזהה ייחודי שאפשר להשתמש בו כדי להבחין בין טריגרים שונים.

`TriggerBuilder`

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
`forDocument(document)`	`DocumentTriggerBuilder`	יוצר ומחזיר `DocumentTriggerBuilder` שמשויך למסמך הנתון.
`forDocument(key)`	`DocumentTriggerBuilder`	יוצרת ומחזירה `DocumentTriggerBuilder` שמשויך למסמך עם המזהה הנתון.
`forForm(form)`	`FormTriggerBuilder`	יוצרת ומחזירה `FormTriggerBuilder` שקשור לטופס הנתון.
`forForm(key)`	`FormTriggerBuilder`	יוצרת ומחזירה `FormTriggerBuilder` שמשויך לטופס עם המזהה הנתון.
`forSpreadsheet(sheet)`	`SpreadsheetTriggerBuilder`	הפונקציה יוצרת ומחזירה אובייקט `SpreadsheetTriggerBuilder` שקשור לגיליון האלקטרוני שצוין.
`forSpreadsheet(key)`	`SpreadsheetTriggerBuilder`	יוצרת ומחזירה `SpreadsheetTriggerBuilder` שקשור לגיליון האלקטרוני עם המזהה שצוין.
`forUserCalendar(emailId)`	`CalendarTriggerBuilder`	מחזירה builder ליצירת טריגרים של יומן.
`timeBased()`	`ClockTriggerBuilder`	יוצרת ומחזירה `ClockTriggerBuilder` ליצירת טריגרים מבוססי-זמן.

`TriggerSource`

מאפיינים

נכס	סוג	תיאור
`SPREADSHEETS`	`Enum`	‫Google Sheets גורם להפעלת הטריגר.
`CLOCK`	`Enum`	אירוע שמבוסס על זמן גורם להפעלת הטריגר.
`FORMS`	`Enum`	הטריגר מופעל על ידי Google Forms.
`DOCUMENTS`	`Enum`	‫Google Docs גורם להפעלת הטריגר.
`CALENDAR`	`Enum`	יומן Google גורם להפעלת הטריגר.

אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers‏.‏ Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.

עדכון אחרון: 2026-03-06 (שעון UTC).

בלוג
קריאת הבלוג Google Workspace Developers
Stack Overflow
שואלים שאלה מתחת לתג google-apps-script
דוגמאות קוד
יש לך אפשרות לעיין בדוגמאות הקוד שלנו או להעתיק אותן כדי ליצור אחת משלך
סרטונים
צפייה במדריכים של Apps Script