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

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

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