סקריפט מקושר לקובץ Google Sheets, Docs, Slides או Forms, אם שנוצר מהמסמך הזה ולא כסקריפט עצמאי. הקובץ שאליו מצורף סקריפט קשור נקרא 'מאגר תגים'. סקריפטים קשורים בדרך כלל פועלים כמו סקריפטים עצמאיים, לא מופיעות ב-Google Drive, לא ניתן לנתק אותן מהקובץ שהם מחויבים אליהם, ומקבלים כמה הרשאות מיוחדות מעל קובץ ההורה.
לתשומת ליבכם: אפשר לקשר גם סקריפטים ל-Google Sites, אבל פרוסות כמעט תמיד כאפליקציות אינטרנט. סקריפטים שקשורים ל-Google Sheets, ל-Docs, ל-Slides או ל-Forms יכולים גם להפוך לאפליקציות אינטרנט, זה לא נפוץ.
יצירת סקריפט קשור
Google Docs , Sheets או Slides
כדי ליצור סקריפט קשור ב-Google Docs, ב-Sheets או ב-Slides, צריך לפתוח מסמך ב- Docs, גיליון אלקטרוני ב-Sheets או מצגת ב-Slides ולוחצים על תוספים > Apps Script. כדי לפתוח מחדש את הסקריפט בתוך בעתיד, עשו את אותו הדבר או פתחו את הסקריפט מרכז הבקרה של Apps Script.
Google Forms
כדי ליצור סקריפט קשור ב-Google Forms, פותחים טופס ולוחצים על 'עוד' > הסקריפט Editor. כדי לפתוח מחדש את הסקריפט בתוך לעשות את אותו הדבר או לפתוח את הסקריפט מרכז הבקרה של Apps Script.
שיטות מיוחדות
סקריפטים קשורים יכולים להפעיל מספר שיטות שסקריפטים עצמאיים לא יכולים:
getActiveSpreadsheet()
getActiveDocument()
,getActivePresentation()
, וגםgetActiveForm()
מאפשרות לסקריפטים קשורים להפנות לקובץ ההורה שלהם בלי להתייחס המזהה של הקובץ.getUi
מאפשר סקריפטים כפופים ניגשים לממשק המשתמש כדי לאפשר לקובץ ההורה שלהם להוסיף תפריטים, תיבות דו-שיח וסרגלי צד בהתאמה אישית.- ב-Google Sheets,
getActiveSheet()
,getActiveRange()
, ו-getActiveCell()
לאפשר לסקריפט לקבוע את הגיליון הנוכחי של המשתמש, את טווח התאים שנבחר או נבחר תא ספציפי.setActiveSheet(sheet)
ו-setActiveRange(range)
לאפשר לסקריפט לשנות את הבחירות האלה. - ב-Google Docs,
getActiveTab()
,getCursor()
, וגםgetSelection()
לאפשר לסקריפט לקבוע את הכרטיסייה הנוכחית של המשתמש, את מיקום המיקום הסמן או הטקסט שנבחר.setActiveTab(tabId)
setCursor(position)
ו-setSelection(range)
לאפשר לסקריפט לשנות את הבחירות האלה.
מידע נוסף זמין במאמר המדריך להרחבת Google Sheets או המדריך להרחבת Google Docs.
תפריטים, תיבות דו-שיח וסרגלי צד בהתאמה אישית
סקריפטים קשורים יכולים להתאים אישית את הגיליונות האלקטרוניים של Google Sheets, Docs ו-Forms על ידי הוספת תפריטים מותאמים אישית תיבות דו-שיח או סרגלי צד. חשוב לזכור אבל סקריפט יכול לקיים אינטראקציה רק עם ממשק המשתמש עבור המופע הנוכחי של קובץ פתוח. כלומר, סקריפט המקושר למסמך אחד לא יכולה להשפיע על ממשק המשתמש של מסמך אחר.
חבילות ערוצים
תוספים שפועלים בתוך Gmail, Google Sheets, Docs, Slides ו-Forms. אם פיתחתם עצמאי שרוצים לשתף אותו עם העולם, Apps Script מאפשר לכם לפרסם את הסקריפט כדי שמשתמשים אחרים יוכלו להתקין אותו מחנות התוספים.
טריגרים
סקריפטים קשורים יכולים להשתמש בטריגרים פשוטים
כמו הפונקציה onOpen()
המיוחדת, שרצה באופן אוטומטי בכל פעם שהקובץ
נפתח על ידי משתמש שיש לו גישת עריכה. כמו כל סוגי הסקריפטים, הן יכולות
להשתמש גם בטריגרים שניתנים להתקנה.
פונקציות מותאמות אישית
פונקציה מותאמת אישית היא פונקציה
סקריפט המאוגד ל-Google Sheets שאליו קוראים ישירות מהתא באמצעות הפונקציה
תחביר =myFunctionName()
. לכן הפונקציות המותאמות אישית דומות
פונקציות מובנות ב-Sheets
כמו AVERAGE
או
SUM
חוץ מההגדרה
ההתנהגות של הפונקציה המותאמת אישית.
גישה לסקריפטים קשורים
רק משתמשים שיש להם הרשאה לערוך מאגר תגים יכולים להריץ סקריפט שכבול אליו. שותפי עריכה שיש להם גישת צפייה בלבד לא יכולים לפתוח את הסקריפט Editor, למרות שאם הם יוצרים עותק של קובץ המאגר, הם יהפכו הבעלים של העותק ויכולים לראות ולהפעיל עותק של הסקריפט.
כדי ללמוד איך לשתף קובץ מכיל של סקריפט, אפשר לעיין במאמר שיתוף קבצים מ: ב-Google Drive