דף זה תורגם על ידי Cloud Translation API.

Script Service

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

שיעורים

שם	תיאור קצר
`AuthMode`	ספירה שמזהה אילו קטגוריות של שירותים מורשים יכולות לפעול באמצעות פונקציה מופעלת ב-Apps Script.
`AuthorizationInfo`	אובייקט שבודק אם המשתמש העניק הרשאה להיקפי ההרשאות הנדרשים של הסקריפט.
`AuthorizationStatus`	ספירה שמציינת את סטטוס ההרשאה של סקריפט.
`CalendarTriggerBuilder`	כלי ליצירת טריגרים ליומן.
`ClockTriggerBuilder`	כלי ליצירת טריגרים לפי שעון.
`DocumentTriggerBuilder`	כלי ליצירת טריגרים למסמכים.
`EventType`	ספירה שמציינת את סוג האירוע שהופעל.
`FormTriggerBuilder`	כלי ליצירת טריגרים של טפסים.
`InstallationSource`	ספירה שמציינת איך הסקריפט הותקן כתוסף עבור המשתמש הנוכחי.
`ScriptApp`	גישה לפרסום סקריפטים ולטריגרים וביצוע פעולות בהם.
`Service`	גישה לפרסום סקריפטים וביצוע פעולות עליו.
`SpreadsheetTriggerBuilder`	כלי ליצירת טריגרים לגיליונות אלקטרוניים.
`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.
`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`	מחזירה אובייקט ליצירת טריגרים של יומן.
`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 ו/או של השותפים העצמאיים שלה.

עדכון אחרון: 2025-12-11 (שעון UTC).

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