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