בכל פרויקט של Google Apps Script נעשה שימוש ב-Google Cloud כדי לנהל הרשאות, שירותים מתקדמים ופרטים נוספים. כדי להגדיר ולנהל את ההגדרות האלה, לכל פרויקט Apps Script יש פרויקט Google Cloud משויך. בפרויקט הסקריפט אפשר להשתמש בפרויקט ברירת מחדל שנוצר אוטומטית על ידי Apps Script, או בפרויקט רגיל שיוצרים בעצמכם. באופן כללי, פרויקטים שמוגדרים כברירת מחדל מתאימים לסקריפטים לשימוש יומיומי, אבל כדאי להשתמש בפרויקט רגיל לכל אפליקציה שהיא מורכבת, באיכות מסחרית או שאתם מתכוונים לפרסם.
אפשר לעבור מפרויקט ברירת מחדל לפרויקט רגיל בכל שלב, אבל אי אפשר לחזור להשתמש בפרויקט ברירת מחדל. מומלץ לבחור את פרויקט בענן שבו הסקריפט משתמש בשלב מוקדם בתהליך הפיתוח. אם תעברו בהמשך, עלולות להיות לכך השלכות, למשל תצטרכו לבקש מהמשתמשים לאשר מחדש את הגישה.
פרויקטים ב-Cloud שמוגדרים כברירת מחדל
כשיוצרים פרויקט Apps Script, נוצר פרויקט בענן שמוגדר כברירת מחדל ופועל ברקע.
- ברוב התסריטים, לא צריך לראות את פרויקט ברירת המחדל הזה או לשנות אותו. Apps Script מטפל באינטראקציות הנדרשות עם Google Cloud. לדוגמה, אם מפעילים שירות מתקדם בעורך של Apps Script, מערכת Apps Script מפעילה את השירות המתקדם בפרויקט ברירת המחדל ב-Cloud כששומרים את פרויקט הסקריפט.
- כדי להפעיל חלק מהסקריפטים, צריך לבצע פעולות במסוף Google Cloud. במקרים האלה, הסקריפט צריך להשתמש בפרויקט בענן רגיל. לדוגמה, כדי להציג יומנים של Google Cloud במסוף Google Cloud, הסקריפט צריך להשתמש בפרויקט רגיל.
כברירת מחדל, בפרויקטים ב-Cloud יש מדיניות של ניהול זהויות והרשאות גישה (IAM) עם רשומה אחת, חשבון שירות של Google שפועל כבעלים של פרויקט ברירת המחדל. חשבון השירות של Google הוא appsdev-apps-dev-script-auth@system.gserviceaccount.com.
הצגה או עדכון של פרויקטים בענן שמוגדרים כברירת מחדל
רוב המשתמשים לא יכולים לאתר, לראות או לערוך פרויקטים שמוגדרים כברירת מחדל ישירות במסוף Google Cloud. אדמינים יכולים לעיין במאמר הצגת פרויקטים ב-Google Cloud שמוגדרים כברירת מחדל.
אם יצרתם את פרויקט הסקריפט לפני 8 באפריל 2019, יכול להיות שאתם משתמשים בפרויקט ברירת מחדל שאפשר לגשת אליו במסוף Google Cloud. כדי לגשת לפרויקט ברירת המחדל, עוברים להגדרות של פרויקט הסקריפט ולוחצים על מספר הפרויקט.
מחיקת פרויקטים ב-Cloud שמוגדרים כברירת מחדל
אדמינים יכולים למחוק פרויקטים ב-Cloud שמוגדרים כברירת מחדל, כמו פרויקטים רגילים ב-Cloud. איך צופים בפרויקטים שמוגדרים כברירת מחדל ב-Cloud או עורכים אותם
משתמשים שאינם אדמינים לא יכולים למחוק פרויקטים שמוגדרים כברירת מחדל באופן ידני. עם זאת, אם תמחקו את פרויקט הסקריפט או תעברו לפרויקט רגיל, Apps Script ימחק את פרויקט ברירת המחדל שמצורף לסקריפט, יחד עם ההגדרות והמידע שלו.
פרויקטים רגילים ב-Cloud
פרויקטים ב-Cloud שמוגדרים כברירת מחדל הם האפשרות הטובה ביותר לרוב פרויקטי הסקריפטים, אלא אם אתם צריכים להגדיר את הפרויקט באופן ידני. במקרים כאלה, צריך להעביר את פרויקט הסקריפט לשימוש בפרויקט רגיל.
בקטעים הבאים מוסבר מתי נדרש פרויקט רגיל ב-Apps Script, מה המאפיינים שלו ומהן המשימות הנפוצות. אפשר לבצע את המשימות האלה רק בפרויקטים רגילים.
מתי נדרשים פרויקטים רגילים ב-Cloud ב-Apps Script
צריך להשתמש בפרויקט רגיל במצבים הבאים:
- כדי לפרסם את פרויקט הסקריפט שלכם כתוסף ל-Google Workspace ב-Google Workspace Marketplace.
- כדי לאמת את לקוח ה-OAuth של פרויקט הסקריפט.
- אם יש לכם אפליקציה שצריכה להריץ פונקציות בפרויקט הסקריפט באמצעות השיטה
scripts.runשל Google Apps Script API. - כדי לראות את היומנים של פרויקט ה-Script ב-Google Cloud במסוף Google Cloud. מסוף Google Cloud מספק כלים נוספים לסינון ולצפייה ביומנים, ויכול להיות שהוא יהיה שימושי יותר מהתצוגה הפשוטה שמספק לוח הבקרה של Apps Script.
- כדי לראות את דוחות השגיאות של פרויקט הסקריפט באמצעות Error Reporting.
- כדי ליצור תיבת דו-שיח לפתיחת קובץ.
- כשרוצים לשלוט ידנית בהגדרות של הפרויקט ב-Google Cloud.
מאפיינים רגילים של פרויקט בענן
לפרויקטים רגילים יש את המאפיינים הבאים:
- גישה לכל ההגדרות של Google Cloud בפרויקט ישירות ממסוף Google Cloud. כך תוכלו להפעיל ממשקי API, לשנות את פרטי ההרשאה ולהגדיר פרטים אחרים.
- כשמוחקים פרויקט של סקריפט או מעבירים אותו לשימוש בפרויקט רגיל אחר, הפרויקט הרגיל המקורי נשאר וניתן לשימוש חוזר.
- כשמפעילים שירות מתקדם בפרויקט של סקריפט, צריך להפעיל באופן ידני את ה-API המתאים בפרויקט הרגיל.
- כמה פרויקטים של סקריפטים ואפליקציות אחרות יכולים לחלוק את אותו פרויקט רגיל. אם אתם מתכוונים לפרסם פרויקט סקריפט בMarketplace כתוסף, הוא צריך להיות פרויקט רגיל משלו. אפליקציות שפורסמו לא יכולות לשתף פרויקטים ב-Cloud עם אפליקציות אחרות.
- אם רוצים להריץ פונקציות בפרויקט סקריפט מאפליקציה אחרת באמצעות שיטת Apps Script API's
scripts.run, פרויקט הסקריפט והאפליקציה שמבצעת את הקריאה צריכים להיות באותו פרויקט רגיל. - כש-Apps Script מבקש ממשתמש לאשר סקריפט שמשתמש בפרויקט רגיל, שם הפרויקט בענן משמש לזיהוי הסקריפט (ולא שם פרויקט הסקריפט). לכן, חשוב להגדיר שם מתאים לפרויקט בענן.
גישה לפרויקט בענן רגיל
כדי לגשת לפרויקט הרגיל שמשויך לפרויקט הסקריפט:
- פותחים את פרויקט Apps Script.
- בצד ימין, לוחצים על הגדרות הפרויקט .
- בקטע Google Cloud Project (פרויקט ב-Google Cloud), לוחצים על מספר הפרויקט.
אפשר למצוא פרויקט רגיל ישירות בדף Manage Resources במסוף Google Cloud.
הפעלת API בפרויקט בענן רגיל
כדי להעניק לאפליקציית Apps Script גישה ל-Google API אחר, צריך להפעיל את ה-API בפרויקט המתאים בענן:
- פותחים את פרויקט בענן.
- לוחצים על סמל התפריט > APIs & Services (ממשקי API ושירותים).