מרכז הבקרה של Apps Script מאפשר לכם לנהל את הפרויקטים שלכם ב-Apps Script ולעקוב אחריהם. אתם יכולים להשתמש במרכז הבקרה כדי לבצע את הפעולות הבאות:
- הצגה וחיפוש של הפרויקטים הקיימים שלכם ב-Apps Script, כולל סקריפטים מוצמדים שמצורפים למסמכיםGoogle Workspace .
- ליצור פרויקטים חדשים.
- הצגת פרטים על הפרויקטים, כמו היקפי ההרשאות של OAuth שבהם הם משתמשים.
- מעקב אחר התקינות והשימוש בפרויקטי הסקריפטים.
- הצגת יומני ההפעלה של הפרויקטים שלכם ושל פרויקטים אחרים שפועלים באמצעות פרטי הכניסה של החשבון.
- מפעילים או משביתים את Apps Script API כדי לאפשר או למנוע מאפליקציות להשתמש ב-API לאינטראקציה עם הפרויקטים של הסקריפטים.
הצגה וחיפוש של פרויקטים
בלוח הבקרה של Apps Script מפורטים כל פרויקטי הסקריפטים שאפשר להציג או לערוך. בתפריט הניווט הימני של מרכז הבקרה, הפרויקטים האלה מחולקים לקטגוריות הבאות:
- פרויקטים שמסומנים בכוכב. פרויקטים שאתם עוקבים אחריהם.
- הפרויקטים שלי. פרויקטים שאתם הבעלים שלהם.
- כל הפרויקטים. פרויקטים שבבעלותכם או שיש לכם הרשאות צפייה או עריכה בהם.
- קבצים ששותפו איתי. פרויקטים שלא בבעלותכם, אבל ששותפו איתכם.
- אשפה. פרויקטים שהסרתם מ-Google Drive.
ברשימות הפרויקטים מוצגים שם הפרויקט, הבעלים שלו והתאריך שבו הוא עודכן לאחרונה. הסמלים שליד שם הפרויקט מציינים אם מדובר בפרויקט עצמאי או בפרויקט מקושר.
הצגת פרטי הפרויקט
כל פרויקט כולל תצוגה שבה אפשר לראות את פרטי המפתחים של הפרויקט. כדי לצפות בפרטים של פרויקט, לוחצים על השורה ברשימת הפרויקטים.
בתצוגת פרטי הפרויקט מוצגים נתונים ותרשימים של שיעור השגיאות, ביצועים ומשתמשים בפרויקט, וגם היקפי ההרשאות של OAuth שנדרשו מכל משתמש קצה שמשתמש בפרויקט. מדדי הנתונים מוגדרים כך:
- שיעור השגיאות. אחוז ההפעלות שנכשלו עקב חריגות שלא זוהו. המדד הזה מחושב כמספר ההפעלות שנכשלו חלקי מספר ההפעלות הכולל בתקופה שהוגדרה.
- ביצועים. מספר הפעמים שפרויקט 'הופעל' או בוצע. מידע נוסף על אופן ההפעלה של פרויקט זמין במאמר סוגי הפעלה.
- משתמשים. מספר המשתמשים (החשבונות) הייחודיים שהפעילו את הפרויקט פעם אחת או יותר במהלך פרק הזמן שצוין. אנחנו לא עוקבים אחרי משתמשים אנונימיים, ולכן הם לא מופיעים במספר המשתמשים או בתרשימים.
כל פריסה של הפרויקט מופיעה ככרטיסייה בדף פרטי הפרויקט מעל לנתונים ולתרשימים. אפשר לבחור את הכרטיסייה כדי לראות את הנתונים המשויכים לפריסה הזו. אם בוחרים באפשרות הכול, מוצגים נתונים מצטברים של כל הפריסות של הפרויקט וביצועים שנובעים ממפתחים שמריצים את הפרויקט מתוך עורך הקוד של Apps Script.
מעקב אחרי פרויקטים
יכול להיות שיש לכם גישה לחלק גדול בהרבה מהפרויקטים ב-Apps Script בהשוואה לפרויקטים שאתם משתמשים בהם או שאתם מנהלים אותם על בסיס קבוע. אפשר לסמן פרויקטים בסימנייה כדי לגשת אליהם בקלות. הוספת פרויקטים למועדפים מאפשרת גם לעקוב אחרי נתונים סטטיסטיים ותרשימים של שימוש מצטבר ושיעור שגיאות בפרויקטים האלה.
כדי לסמן פרויקט בכוכב, לוחצים על סמל האפשרויות הנוספות > הוספת כוכב משמאל לשורה של הפרויקט. אפשר גם לסמן פרויקט בכוכב בלחיצה על סמל האפשרויות הנוספות בזמן הצגת פרטי הפרויקט.
בתפריט הניווט הימני, אפשר לבחור באפשרות פרויקטים שמסומנים בכוכב כדי לראות את הפרויקטים שסימנתם. לוחצים על כרטיס הניקוד שיעור שגיאות, הפעלות או משתמשים בחלק העליון של הדף כדי להציג את התרשימים המשויכים לכל הפרויקטים שמסומנים בכוכב ב-7 הימים האחרונים.
כדי להסיר כוכב מפרויקט, לוחצים על סמל האפשרויות הנוספות בשורה של הפרויקט ובוחרים באפשרות הסרת הכוכב.
ניהול ביצועים
בלוח הבקרה של Apps Script אפשר לראות ולנהל את ההפעלות הנפרדות של פונקציות בפרויקטים של Apps Script. כדי לראות יומן מלא של פעולות שהתבצעו לאחרונה, בוחרים באפשרות My Executions בתפריט הניווט הימני.
בחלונית My Executions כברירת מחדל מוצג יומן של כל ההפעלות הקודמות וההפעלות הנוכחיות בפרויקטים שבהם אתם הבעלים, העורכים או הצופים. הרשימה יכולה לכלול גם הפעלות של פונקציות בפרויקטים שאין לכם גישה אליהם, אם הן פועלות בשמכם (לדוגמה, תוספים שהתקנתם והרצתם). ברשימת הביצועים מוצגת רק הפונקציה הראשונית שנקראת כדי להתחיל את הביצוע. לא מוצגות בו כל הפונקציות שהופעלו במהלך הביצוע.
אפשר לשלוט בסוג ההפעלה שמדווח ביומן באמצעות המסננים בחלק העליון של התצוגה. כל שורה ביומן מייצגת הפעלה אחת. בעמודות Start Time (שעת ההתחלה), Duration (משך הזמן) ו-Status (סטטוס) מוצג המידע המתאים לגבי ההפעלה הזו.
בעמודה Function מוצג שם הפונקציה שהפעילה את הביצוע. אם אין לכם גישה לפרויקט הסקריפט התואם של הביצוע, אבל הוא הופעל בשמכם, לא יופיע שם בעמודה הזו.
בעמודה סוג מוצג מה שביצע את ההפעלה. הערכים כוללים:
- Add On (תוסף). ההרצה התבצעה מתוסף.
- Execution API. הביצוע הגיע מהפעלה של API של Apps Script.
- Time Driven. הביצוע נגרם על ידי אירוע זמן.
- טריגר. ההרצה נבעה ממקור של טריגר.
- Webapp. ההפעלה הגיעה מאפליקציית אינטרנט שנפרסה.
- עריכה. ההפעלה הגיעה מעורך Apps Script.
סיום ביצוע
בסטטוס 'הפעלה' מוצגות הפעלות ארוכות שנמצאות כרגע בתהליך. כדי להפסיק את ההרצות האלה, לוחצים על סמל האפשרויות הנוספות > סיום משמאל לשורת הפרויקט.
הגדרות
אפשר לשנות את ההגדרות של מרכז הבקרה על ידי בחירה באפשרות Settings בתפריט הניווט השמאלי.
בחלונית Settings יש מתג לApps Script API. כך תוכלו להעניק ל-API גישה לפרויקטי הסקריפטים.
כדי לגשת למתג הזה, לוחצים על התווית Google Apps Script API בחלונית הגדרות. תיפתח חלונית חדשה עם טקסט אזהרה ומפסק החלפת מצב. כברירת מחדל, הגישה לפרויקטים של הסקריפטים מושבתת כברירת מחדל, מטעמי אבטחה. אחרי הענקת הגישה, כל אפליקציית צד שלישי שנתתם לה הרשאה תוכל להשתמש ב-API כדי לשנות את הסקריפטים והפריסות שלכם. תמיד תוכלו לבטל את הגישה הזו בחלונית הגדרות.
מידע נוסף זמין במדריך לגישה ל-Apps Script API.