סקריפט משויך לקובץ ב-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, פותחים טופס ולוחצים על סמל האפשרויות הנוספות > כלי לעריכת סקריפטים. כדי לפתוח מחדש את הסקריפט בעתיד, מבצעים את אותה פעולה או פותחים את הסקריפט ממרכז הבקרה של 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 על ידי הוספה של תפריטים מותאמים אישית ותיבות דו-שיח או סרגלי צד. חשוב לזכור שסקריפט יכול ליצור אינטראקציה עם ממשק המשתמש רק עבור המופע הנוכחי של קובץ פתוח. כלומר, סקריפט שמשויך למסמך אחד לא יכול להשפיע על ממשק המשתמש של מסמך אחר.
טריגרים
סקריפטים שקשורים לקובץ יכולים להשתמש בטריגרים פשוטים כמו הפונקציה המיוחדת onOpen(), שמופעלת אוטומטית בכל פעם שמשתמש עם הרשאת עריכה פותח קובץ. בדומה לכל סוגי הסקריפטים, הם יכולים להשתמש גם בטריגרים שאפשר להתקין.
פונקציות מותאמות אישית
פונקציה בהתאמה אישית היא פונקציה בסקריפט שמקושר ל-Google Sheets, שאפשר להפעיל ישירות מתא באמצעות התחביר =myFunctionName(). לכן, פונקציות בהתאמה אישית דומות למאות פונקציות מובנות ב-Sheets, כמו AVERAGE או SUM, רק שאתם מגדירים את ההתנהגות של הפונקציה בהתאמה אישית.
גישה לסקריפטים מקושרים
רק משתמשים שיש להם הרשאת עריכה במאגר יכולים להריץ את הסקריפט שקשור אליו. שותפי עריכה שיש להם רק הרשאת צפייה לא יכולים לפתוח את עורך הסקריפטים, אבל אם הם יוצרים עותק של קובץ המאגר, הם הופכים לבעלים של העותק ויכולים לראות ולהריץ עותק של הסקריפט.
כאן מוסבר איך משתפים קבצים מ-Google Drive.