לוח הבקרה של Google Apps Script

לוח הבקרה של 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 (מבוסס על זמן). הביצוע נגרם על ידי אירוע זמן.
• Trigger. ההרצה התחילה ממקור הפעלה.
• אפליקציית אינטרנט. ההפעלה התחילה מאפליקציית אינטרנט שפרסמתם.
• עריכה. ההרצה התחילה בכלי לעריכת סקריפטים של Apps Script.

סיום הפעלות

הסטטוס Running מציין שהפעלה ארוכה נמצאת בתהליך. כדי להפסיק את ההרצות האלה, משמאל לשורת הפרויקט, לוחצים על סמל האפשרויות הנוספות > סיום.

הגדרות

כדי לשנות את הגדרות לוח הבקרה, בוחרים באפשרות הגדרות בתפריט הניווט הימני.

בחלונית הגדרות יש מתג ל-Apps Script API. כך תוכלו להעניק ל-API גישה לפרויקטים של סקריפטים.

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

מידע נוסף זמין במדריך לגישה ל-Apps Script API.