לוח הבקרה של 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 מוצג שם הפונקציה שהפעילה את הביצוע. אם אין לכם גישה לפרויקט הסקריפט התואם של הביצוע, אבל הוא הופעל בשמכם, לא יופיע שם בעמודה הזו.
בעמודה Type מוצג מה יזם את הביצוע. הערכים כוללים:
- Add On (תוסף). ההרצה התבצעה מתוסף.
- Execution API. הביצוע הגיע מהפעלה של Apps Script API.
- Time Driven. הביצוע נגרם על ידי אירוע זמן.
- טריגר. ההפעלה נוצרה ממקור של טריגר.
- אפליקציה לאינטרנט. הביצוע הגיע מאפליקציית אינטרנט שנפרסה.
- עריכה. הביצוע הגיע מעורך Apps Script.
סיום של הרצות
בסטטוס 'הפעלה' מוצגות פעולות ארוכות שמתבצעות כרגע. כדי להפסיק את ההרצות האלה, לוחצים על סמל האפשרויות הנוספות > סיום משמאל לשורת הפרויקט.
הגדרות
כדי לשנות את ההגדרות של מרכז הבקרה, בוחרים באפשרות הגדרות בתפריט הניווט הימני.
בחלונית Settings יש מתג לApps Script API. כך תוכלו להעניק ל-API גישה לפרויקטי הסקריפטים.
כדי לגשת למתג הזה, לוחצים על התווית Google Apps Script API בחלונית Settings. תיפתח חלונית חדשה עם טקסט אזהרה ומפסק החלפת מצב. הגישה לפרויקטים של הסקריפטים מושבתת כברירת מחדל כאמצעי זהירות. אחרי שתעניקו גישה, כל אפליקציית צד שלישי שתאשרו תוכל להשתמש ב-API כדי לשנות את הסקריפטים והפריסות שלכם. תמיד תוכלו לבטל את הרשאת הגישה הזו בחלונית הגדרות.
מידע נוסף זמין במדריך לגישה ל-Apps Script API.