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

במאמר הזה מפורטת סקירה כללית על השיטות של Apps Script API שאפשר להשתמש בהן כדי ליצור פרויקטים ב-Apps Script, לקרוא ולשנות אותם, ולעקוב אחריהם. בדף לדוגמה של Project Management מוצגות דוגמאות לבקשות לניהול API. במסמכי התיעוד של כל אחת מהשיטות מופיעים פרטים על ההטמעה.

סקירה כללית של שיטות ה-API
יצירת פרויקטים	projects.create Results: יצירת פרויקט בסיסי וריק ללא קובצי פרויקט, ועם מניפסט של הפרויקט שמוגדר כברירת מחדל. אפשרויות: אתם יכולים לתת שם לפרויקט. אפשר גם ליצור סקריפט קשור על ידי הזנת מזהה Google Drive של קובץ Google Docs, Google Sheets, Google Forms או Slides, שישמש כהורה של הסקריפט.
קריאת מטא-נתונים של פרויקט	projects.get Results: אחזור אובייקט Project, שמייצג את המטא-נתונים של הפרויקט. הנתונים האלה כוללים את שם הפרויקט, מזהה הסקריפט, יצירת המשתמש, שעת היצירה ופרטים נוספים.
קריאת תוכן הפרויקט	projects.getContent Results: הפונקציה מחזירה מערך של אובייקטים של File – אחד לכל קוד וקובץ HTML בפרויקט. הרשימה כוללת גם את מניפסט הפרויקט כקובץ JSON. האובייקטים של הקבצים מכילים את תוכן המקור של הקובץ (File.source) ומטא-נתונים נוספים, כמו רשימת הפונקציות שבקובץ (File.functionSet). אפשרויות: תוכלו לציין איזו גרסה של התוכן לאחזר באמצעות פרמטר של שאילתה.
עדכון תוכן הפרויקט	פרויקטים.updateContent תוצאות: שינוי התוכן של הקובץ בפרויקט סקריפט. צריך לספק את התוכן החדש כמערך של אובייקטים מסוג File. אחד מהאובייקטים האלה מסוג File חייב להיות מסוג JSON ולייצג את מניפסט הפרויקט החדש של פרויקט הסקריפט. התוכן החדש נשמר בתור גרסת ה-HEAD של הפרויקט. משתמשים בו כשהסקריפט מופעל כטריגר, בעורך הסקריפטים, במצב תצוגה מקדימה של תוספים, או בתור אפליקציית אינטרנט או Apps Script API במצב פיתוח. הערה: כשמעדכנים תוכן של פרויקט בסקריפט, מקובל לשלוח קודם בקשת projects.getContent כדי לאחזר מערך של ה-File הקיימים, להביע תשוקה לאובייקטים האלה, ואז להשתמש ב-File כקלט לבקשת projects.updateContent. אזהרה: התוכן החדש מחליף את כל הקבצים הקיימים בפרויקט הסקריפט. קבצים שלא עודכנו בהתאם לבקשה יוסרו.
קריאה של מדדי הפרויקט	projects.getMetrics תוצאות: קריאת מדדים מסוימים לגבי פרויקט. המדדים האלה כוללים את מספר המשתמשים, המספר הכולל של ההפעלות, המספר הכולל של שגיאות ההפעלה ופרטים נוספים. משתמשים ב- MetricType כדי לציין את המידע המבוקש. אפשרויות: הגבלת התוצאות לפריסות ספציפיות או לפונקציות סקריפט ספציפיות באמצעות MetricsFilter. אפשר גם להגדיר מרווח של מדד ספציפי באמצעות MetricsIntervalConfig.