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

פרויקט סקריפט מייצג אוסף של קבצים ומשאבים ב-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. נותנים שם לפרויקט ולוחצים על שינוי השם.

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

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

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

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

פרטים נוספים זמינים במדריך ל-Command Line Interface באמצעות 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 בשורת הפקודה. כדי להשתמש ב-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 בו-זמנית.

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

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

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