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