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

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

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

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

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

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

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

1. עוברים אל script.google.com.
2. לוחצים על פרויקט חדש.
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 מטרמינל.

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

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

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

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

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

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

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