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

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

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

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

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

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

כדי ליצור פרויקט עצמאי מ-Apps Script:

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

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

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

יצירת פרויקט שקשור למסמך מ-Google Docs, מ-Google Sheets או מ-Google Slides

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

יצירת פרויקט שקשור למאגר תגים מ-Google Forms

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

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

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

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

מחיקת פרויקט שמשויך למאגר

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

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

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

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

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

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

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

יצירת קובץ

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

איך מוחקים קובץ

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

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

ייצוא קבצים מפרויקט 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 בו-זמנית.

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

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

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