לוח הבקרה של Apps Script מאפשר לכם לנהל ולעקוב אחרי פרויקטים של Apps Script. אתם יכולים להשתמש בלוח הבקרה כדי לבצע כל אחת מהפעולות הבאות:
- הצגה וחיפוש של פרויקטים קיימים ב-Apps Script, כולל סקריפטים קשורים שמצורפים לGoogle Workspace מסמכים.
- יצירת פרויקטים חדשים.
- לראות פרטים על הפרויקטים, כמו היקפי ההרשאות של OAuth שבהם נעשה שימוש.
- מעקב אחר התקינות והשימוש בפרויקטים של סקריפטים.
- הצגת יומני ביצוע של הפרויקטים שלכם ושל פרויקטים אחרים שפועלים באמצעות פרטי הכניסה של החשבון שלכם.
- מחליפים את המצב של Apps Script API כדי לאפשר לאפליקציות להשתמש ב-API כדי ליצור אינטראקציה עם פרויקטים של סקריפטים, או כדי למנוע זאת.
הצגה וחיפוש של פרויקטים
במרכז הבקרה של Apps Script מופיעה רשימה של כל פרויקטי הסקריפטים שאפשר להציג או לערוך. בתפריט הניווט הימני של מרכז הבקרה, הפרויקטים האלה מחולקים לקטגוריות הבאות:
- פרויקטים שסומנו בכוכב. פרויקטים שעוקבים אחריהם.
- הפרויקטים שלי. פרויקטים שאתם הבעלים שלהם.
- כל הפרויקטים. פרויקטים שבבעלותכם או שיש לכם הרשאות צפייה או עריכה לגביהם.
- קבצים ששותפו איתי. פרויקטים שלא בבעלותכם, אבל שותפו איתכם.
- אשפה. פרויקטים שהסרתם מ-Google Drive.
ברשימות הפרויקטים מוצגים שם הפרויקט, הבעלים ותאריך השינוי האחרון. הסמלים שליד שם הפרויקט מציינים אם הפרויקט הוא עצמאי או מקורי.
הצגת פרטי הפרויקט
כל פרויקט כולל תצוגה שבה אפשר לראות פרטים על המפתחים של הפרויקט. כדי לראות את הפרטים של פרויקט, לוחצים על השורה ברשימת הפרויקטים.
בתצוגת פרטי הפרויקט מוצגים נתונים וגרפים לגבי הפרויקט, כולל שיעור השגיאות, הביצועים והמשתמשים, וגם היקפי ההרשאות של OAuth שנדרשו מכל משתמש קצה שהשתמש בפרויקט. הגדרות מדדי הנתונים:
- שיעור השגיאות. אחוז ההרצות שנכשלו בגלל חריגים שלא נתפסו. המדד הזה מחושב כך: מספר ההפעלות שנכשלו חלקי מספר ההפעלות הכולל בתקופת הזמן שהוגדרה.
- הפעלות. מספר הפעמים שפרויקט הופעל. מידע נוסף על האופן שבו אפשר להריץ פרויקט מופיע במאמר סוגי הרצה.
- משתמשים. מספר המשתמשים הייחודיים (חשבונות) שהפעילו את הפרויקט פעם אחת או יותר במהלך תקופת הזמן שצוינה. אנחנו לא עוקבים אחרי משתמשים אנונימיים, ולכן הם לא נכללים בספירת המשתמשים או בתרשימים.
כל פריסה של הפרויקט מופיעה ככרטיסייה בדף Project Details מעל הנתונים והגרפים. אפשר לבחור את הכרטיסייה כדי לראות את הנתונים שמשויכים לפריסה הזו. אם בוחרים באפשרות ALL, מוצגים נתונים מצטברים של כל הפריסות של הפרויקט ושל ההרצות שנובעות מהרצת הפרויקט על ידי מפתחים מתוך עורך הקוד של Apps Script.
מעקב אחרי פרויקטים
יכול להיות שיש לכם גישה להרבה יותר פרויקטים של Apps Script ממה שאתם משתמשים בהם או מנהלים אותם באופן קבוע. כדי להוסיף פרויקטים לסימניות ולגשת אליהם בקלות, אפשר לסמן אותם בכוכב. כשמסמנים פרויקטים בכוכב, אפשר גם לעקוב אחרי נתוני שימוש מצטברים ושיעורי שגיאות, וגם אחרי גרפים של הפרויקטים האלה.
כדי לסמן פרויקט בכוכב, משמאל לשורה של הפרויקט, לוחצים על סמל האפשרויות הנוספות > הוספת כוכב. אפשר גם להוסיף פרויקט למועדפים בלחיצה על סמל האפשרויות הנוספות כשצופים בפרטי הפרויקט.
בסרגל הניווט הימני, אפשר ללחוץ על פרויקטים עם כוכב כדי לראות את הפרויקטים שסימנתם בכוכב. לוחצים על כרטיס הניקוד שיעור השגיאות, הפעלות או משתמשים בחלק העליון של הדף כדי לראות את הגרפים המשויכים לכל הפרויקטים המסומנים בכוכב ב-7 הימים האחרונים.
כדי להסיר כוכב מפרויקט, לוחצים על סמל האפשרויות הנוספות בשורת הפרויקט ובוחרים באפשרות הסרת הכוכב.
ניהול ההרצות
אפשר להשתמש בלוח הבקרה של Apps Script כדי לראות ולנהל ביצועים ספציפיים של פונקציות בפרויקט Apps Script. כדי לראות יומן מלא של ההרצות האחרונות, בוחרים באפשרות ההרצות שלי בסרגל הניווט הימני.
בחלונית ההרצות שלי מוצג כברירת מחדל יומן של כל ההרצות הקודמות והנוכחיות של פרויקטים שבהם יש לכם הרשאת בעלים, עריכה או צפייה. הרשימה הזו יכולה לכלול גם הפעלות של פונקציות בפרויקטים שאין לכם גישה אליהם, אם הן מופעלות בשמכם (לדוגמה, תוספים שהתקנתם והפעלתם). ברשימת ההפעלה מוצגת רק הפונקציה הראשונית שמופעלת כדי להתחיל את ההפעלה. הוא לא מציג כל פונקציה שנקראה במהלך ההרצה הזו.
אפשר לשלוט בסוג הביצוע שמדווח ביומן באמצעות המסננים בחלק העליון של התצוגה. כל שורה ביומן מייצגת ביצוע יחיד. בעמודות שעת התחלה, משך וסטטוס מוצג המידע הרלוונטי לגבי ההפעלה הזו.
בעמודה Function (פונקציה) מופיע השם של הפונקציה שהפעילה את הביצוע. אם אין לכם גישה לפרויקט הסקריפט התואם של ההרצה, אבל הוא הופעל בשמכם, לא יופיע שם בעמודה הזו.
בעמודה סוג מוצג מה הפעיל את הביצוע. הערכים כוללים:
- הוספה. ההרצה התחילה מתוסף.
- Execution API. הביצוע התחיל מהפעלה של Apps Script API.
- Time Driven (מבוסס על זמן). הביצוע נגרם על ידי אירוע זמן.
- טריגר. ההרצה התחילה ממקור הפעלה.
- אפליקציית אינטרנט. ההפעלה התחילה מאפליקציית אינטרנט שפרסתם.
- עריכה. הביצוע התחיל בעורך של Apps Script.
סיום הרצות של הקוד
הפעלה ארוכה שנמצאת כרגע בתהליך מסומנת בסטטוס 'פועל'. כדי להפסיק את ההרצות האלה, משמאל לשורה של הפרויקט, לוחצים על סמל האפשרויות הנוספות > סיום.
הגדרות
כדי לשנות את הגדרות מרכז הבקרה, בוחרים באפשרות הגדרות בתפריט הניווט הימני.
בחלונית הגדרות יש מתג להפעלה של Apps Script API. כך תוכלו להעניק ל-API גישה לפרויקטים של סקריפטים.
כדי לגשת למתג הזה, לוחצים על התווית Google Apps Script API בחלונית הגדרות. תיפתח חלונית חדשה עם טקסט אזהרה ומתג. הגישה לפרויקטים של סקריפטים מושבתת כברירת מחדל כאמצעי זהירות. אחרי שתאשרו גישה, כל אפליקציית צד שלישי שתאשרו לה גישה תוכל להשתמש ב-API כדי לשנות את הסקריפטים והפריסות שלכם. אפשר לבטל את הגישה הזו בכל שלב בחלונית הגדרות.
מידע נוסף זמין במדריך לגישה ל-Apps Script API.