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

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

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

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

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

איך יוצרים פרויקט עצמאי

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

יצירת קובץ

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

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

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

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

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

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

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

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

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על Project Settings (הגדרות הפרויקט) .
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 בו-זמנית, יכול להיות שתתקשו לגשת לתוספים ולאפליקציות האינטרנט. אין תמיכה בהתחברות לכמה חשבונות Google בו-זמנית ב-Apps Script, בתוספים ובאפליקציות אינטרנט.

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

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

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