דף זה תורגם על ידי 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`	הפונקציה מקבלת את כתובת ה-URL לאישור שאפשר להשתמש בה כדי להעניק גישה לסקריפט.
`getAuthorizedScopes()`	`String[]`	הפונקציה מקבלת רשימה של היקפי הרשאה לסקריפט.

`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`	Enumeration שמייצג את ימי השבוע.

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`deleteTrigger(trigger)`	`void`	הסרת הטריגר הנתון כדי שהוא לא יפעל יותר.
`getAuthorizationInfo(authMode)`	`AuthorizationInfo`	הפונקציה מקבלת אובייקט שבודק אם המשתמש העניק הרשאה לכל הדרישות של הסקריפט.
`getAuthorizationInfo(authMode, oAuthScopes)`	`AuthorizationInfo`	הפונקציה מקבלת אובייקט שבודק אם המשתמש העניק הרשאה להיקפי ההרשאות המבוקשים.
`getIdentityToken()`	`String`	הפונקציה מקבלת אסימון זהות של 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`	יצירת בונה לאסימון מצב שאפשר להשתמש בו ב-API של קריאה חוזרת (כמו תהליך 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-01-08 (שעון UTC).

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