פרויקטים של סקריפטים

פרויקט סקריפט מייצג אוסף של קבצים ומשאבים ב-Google Apps Script, ולפעמים נקרא פשוט 'סקריפט'. לפרויקט סקריפט יש קובץ סקריפט אחד או יותר, שיכולים להיות קובצי קוד (עם סיומת .gs) או קובצי HTML (סיומת .html). אפשר גם לכלול JavaScript ו-CSS בקובצי HTML.

בעורך הסקריפטים תמיד יש פרויקט אחד בלבד פתוח בכל זמן נתון. אתם יכולים לפתוח כמה פרויקטים בכמה חלונות או כרטיסיות בדפדפן.

יצירה ומחיקה של פרויקטים

בקטע הזה מוסבר איך יוצרים ומוחקים פרויקטים של Apps Script שעומדים בפני עצמם או מקושרים לקונטיינר.

יצירת פרויקט עצמאי

כך יוצרים פרויקט עצמאי מ-Apps Script:

1. עוברים אל script.google.com.
2. לוחצים על New Project.
3. בעורך הסקריפטים, לוחצים על Untitled project.
4. נותנים שם לפרויקט ולוחצים על שינוי השם.

יצירת פרויקט עצמאי מ-Google Drive

1. פותחים את Google Drive.
2. לוחצים על חדש > אפשרויות נוספות > Google Apps Script.

יצירת פרויקט בקונטיינר מ-Google Docs,‏ Sheets או Slides

1. פותחים מסמך ב-Docs, גיליון אלקטרוני ב-Sheets או מצגת ב-Slides.
2. לוחצים על תוספים > Google Apps Script.
3. בעורך הסקריפטים, לוחצים על Untitled project.
4. נותנים שם לפרויקט ולוחצים על Rename.

יצירת פרויקט שקשור לקונטיינר מ-Google Forms

1. פותחים טופס ב-Google Forms.
2. לוחצים על סמל האפשרויות הנוספות > עורך קובצי סקריפט.
3. בעורך הסקריפטים, לוחצים על Untitled project.
4. נותנים שם לפרויקט ולוחצים על Rename.

יצירת פרויקט עצמאי באמצעות כלי שורת הפקודה clasp

clasp הוא כלי בשורת הפקודה שמאפשר ליצור, למשוך/לדחוף ולפרוס פרויקטים של Apps Script מהטרמינל.

למידע נוסף, עיינו במדריך בנושא ממשק שורת הפקודה (CLI) באמצעות clasp.

מחיקת פרויקט שמקושר לקונטיינר

אזהרה: אחרי שמוחקים פרויקט Apps Script שמקושר לקונטיינר, אי אפשר לשחזר אותו.

1. פותחים את הפרויקט בקונטיינר באמצעות השיטה המתאימה שמפורטת למעלה.
2. בפינה הימנית העליונה, לוחצים על סקירה כללית .
3. בפינה השמאלית העליונה, לוחצים על סמל ההסרה > מחיקה לתמיד.

רק הבעלים של הקונטיינר יכול לראות את אפשרויות תפריט המחיקה.

מחיקת פרויקט עצמאי

1. עוברים אל script.google.com.
2. משמאל לפרויקט שרוצים למחוק, לוחצים על סמל האפשרויות הנוספות > הסרה > הסרה.

ניהול קבצים בפרויקט

יצירת קובץ

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על עריכה > הוספה של .
3. בוחרים את סוג הקובץ שרוצים ליצור ונותנים לו שם.

מחיקת קובץ

לא ניתן לשחזר קבצים שנמחקו.

1. פותחים את הפרויקט ב-Apps Script.
2. בצד ימין, לוחצים על עריכה .
3. לצד הקובץ שרוצים למחוק, לוחצים על סמל האפשרויות הנוספות > מחיקה.

ייצוא קבצים מפרויקט Apps Script

כדי להוציא קובצי קוד מ-Apps Script, אתם יכולים להעתיק את הקוד מכל קובץ ולהדביק אותו בכלי לעריכת טקסט המועדף עליכם או להשתמש בפס בשורת הפקודה. כדי להשתמש ב-clasp, אפשר לעיין במאמר הורדת פרויקט סקריפט.

הגדרת אזור הזמן של פרויקט

אפשר להגדיר אזור זמן לפרויקט Apps Script. הפונקציות שמבוצעות על ידי הסקריפט משתמשות באזור הזמן הזה.

1. פותחים את הפרויקט ב-Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט .
3. בקטע אזור זמן, בוחרים את אזור הזמן שבו רוצים להשתמש.

אם רוצים להשתמש באזור זמן שונה מזה של פרויקט הסקריפט בפונקציה ספציפית, צריך להזין את אזור הזמן בפונקציה באופן מפורש. לדוגמה, בדוגמה הבאה כל פונקציה יוצרת אירוע חדש ביומן Google. כברירת מחדל, הפונקציה הראשונה מוגדרת לאזור הזמן של הפרויקט. הפונקציה השנייה מציינת את אזור הזמן של האוקיינוס השקט, כך שהאירוע מתוזמן לפי שעון החוף המערבי, ללא קשר לאזור הזמן של הפרויקט.

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

פתרון בעיות עם כמה חשבונות Google

אם אתם מחוברים לכמה חשבונות Google בו-זמנית, יכול להיות שתיתקלו בבעיות בגישה לתוספים ולאפליקציות האינטרנט. ב-Apps Script, בתוספים או באפליקציות אינטרנט אי אפשר להתחבר לכמה חשבונות Google בו-זמנית או להתחבר לכמה חשבונות Google.

• אם פותחים את עורך Apps Script כשמחוברים ליותר מחשבון אחד, Google מבקשת לבחור את החשבון שבו רוצים להמשיך.

• אם פותחים אפליקציה או תוסף לאינטרנט ונתקלים בבעיות שקשורות להתחברות לכמה חשבונות בו-זמנית, אפשר לנסות את אחד מהפתרונות הבאים:

  • יוצאים מכל חשבונות Google ונכנסים רק לחשבון שבו נמצאים התוסף או אפליקציית האינטרנט שבהם רוצים לגשת.
  • פותחים חלון פרטי ב-Google Chrome או חלון מקביל לגלישה פרטית, ונכנסים לחשבון Google שבו נמצאים התוסף או אפליקציית האינטרנט שבהם רוצים לגשת.