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