פרויקטים ב-Google Cloud

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

בכל שלב אפשר לעבור מפרויקט ברירת מחדל לפרויקט רגיל, אבל אי אפשר לחזור להשתמש בפרויקט ברירת מחדל. מומלץ לבחור את פרויקט Cloud שבו הסקריפט משתמש בשלב מוקדם בתהליך הפיתוח. אם תעברו בהמשך, יכולות להיות לכך השלכות, למשל תצטרכו לבקש מהמשתמשים לאשר מחדש את הגישה.

פרויקטים ב-Cloud שמוגדרים כברירת מחדל

כשיוצרים פרויקט Apps Script, מערכת Apps Script יוצרת פרויקט Cloud שמוגדר כברירת מחדל ופועל ברקע.

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

כברירת מחדל, בפרויקטים ב-Cloud יש מדיניות של ניהול זהויות והרשאות גישה (IAM) עם רשומה אחת, חשבון שירות של Google שפועל כבעלים של פרויקט ברירת המחדל. חשבון השירות של Google הוא [email protected].

הצגה או עדכון של פרויקטים בענן שמוגדרים כברירת מחדל

רוב המשתמשים לא יכולים לאתר, להציג או לערוך פרויקטים שמוגדרים כברירת מחדל ישירות במסוף Google Cloud. אדמינים יכולים לעיין במאמר הצגת פרויקטים ב-Google Cloud שמוגדרים כברירת מחדל.

אם יצרתם את פרויקט הסקריפט לפני 8 באפריל 2019, יכול להיות שאתם משתמשים בפרויקט ברירת מחדל שאפשר לגשת אליו במסוף Google Cloud. כדי לגשת לפרויקט ברירת המחדל, עוברים להגדרות של פרויקט הסקריפט ולוחצים על מספר הפרויקט.

מחיקת פרויקטים בענן שמוגדרים כברירת מחדל

אדמינים יכולים למחוק פרויקטים ב-Cloud שמוגדרים כברירת מחדל, כמו פרויקטים רגילים ב-Cloud. איך צופים בפרויקטים ב-Cloud או עורכים אותם?

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

פרויקטים רגילים ב-Cloud

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

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

מתי נדרשים פרויקטים רגילים ב-Cloud Platform ב-Apps Script

צריך להשתמש בפרויקט רגיל במקרים הבאים:

• כדי לפרסם את פרויקט הסקריפט שלכם כתוסף ב-Google Workspace Marketplace.
• כדי לאמת את לקוח ה-OAuth של פרויקט הסקריפט.
• אם יש לכם אפליקציה שצריכה להריץ פונקציות בפרויקט הסקריפט באמצעות השיטה scripts.run של Apps Script API.
• כדי לראות את היומנים של Google Cloud של פרויקט הסקריפט במסוף Google Cloud. מסוף Google Cloud מספק יותר כלים לסינון ולצפייה ביומנים, ויכול להיות שימושי יותר מהתצוגה הפשוטה שמספק לוח הבקרה של Apps Script.
• כדי לראות את דוחות השגיאות של פרויקט הסקריפט באמצעות דיווח על שגיאות.
• כדי ליצור תיבת דו-שיח לפתיחת קובץ.
• כשרוצים לשלוט באופן ידני בהגדרות של Google Cloud בפרויקט.

מאפיינים רגילים של פרויקט ב-Cloud

לפרויקטים רגילים יש את המאפיינים הבאים:

• אפשר לגשת לכל ההגדרות של Google Cloud בפרויקט ישירות ממסוף Google Cloud. כך תוכלו להפעיל ממשקי API, לשנות את פרטי ההרשאה ולהגדיר פרטים נוספים.
• כשמוחקים פרויקט של סקריפט או מעבירים אותו לשימוש בפרויקט רגיל אחר, הפרויקט הרגיל המקורי נשאר וניתן לעשות בו שימוש חוזר.
• כשמפעילים שירות מתקדם בפרויקט של סקריפט, צריך להפעיל באופן ידני את ה-API המתאים בפרויקט הרגיל.
• מספר פרויקטים של סקריפטים ואפליקציות אחרות יכולים לחלוק את אותו פרויקט רגיל. אם אתם מתכוונים לפרסם פרויקט סקריפט ב-Google Workspace Marketplace כתוסף, הוא צריך להיות פרויקט סטנדרטי משלו. אפליקציות שפורסמו לא יכולות לשתף פרויקטים בענן עם אפליקציות אחרות.
• אם רוצים להריץ פונקציות בפרויקט סקריפט מאפליקציה אחרת באמצעות השיטה scripts.run של Apps Script API, פרויקט הסקריפט והאפליקציה שמבצעת את הקריאה צריכים להיות באותו פרויקט רגיל.
• כש-Apps Script מבקש ממשתמש לאשר סקריפט שמשתמש בפרויקט רגיל, שם הפרויקט בענן משמש לזיהוי הסקריפט (ולא שם פרויקט הסקריפט). לכן, חשוב להגדיר שם מתאים לפרויקט ב-Cloud.

גישה לפרויקט רגיל ב-Cloud

כדי לגשת לפרויקט הרגיל שמשויך לפרויקט הסקריפט:

1. פותחים את פרויקט Apps Script.
2. בצד ימין, לוחצים על הגדרות הפרויקט settings.
3. בקטע פרויקט Google Cloud Platform ‏ (GCP), לוחצים על מספר הפרויקט.

אפשר גם למצוא פרויקט רגיל ישירות בדף Manage Resources במסוף Google Cloud.

הפעלת API בפרויקט רגיל ב-Cloud

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

1. פותחים את פרויקט Cloud.
2. לוחצים על סמל התפריט menu > APIs & Services (ממשקי API ושירותים).
3. לוחצים על Enable APIs and Services.
4. בתיבת החיפוש, מזינים את ה-API שרוצים להפעיל ומקישים על Enter.
5. לוחצים על ה-API מתוצאות החיפוש ואז על הפעלה כדי להפעיל את ה-API בפרויקט הזה ב-Cloud.

יכול להיות שתתבקשו לאשר את התנאים וההגבלות של Google APIs או של Google Cloud. חשוב לקרוא את התנאים וההגבלות בעיון לפני שמאשרים אותם.

בהתאם לאפליקציה, יכול להיות שתצטרכו גם להגדיר את ה-API על ידי בחירתו במרכז הבקרה APIs & Services.

איך קובעים את המזהה והמספר של פרויקט רגיל ב-Cloud

לכל הפרויקטים ב-Cloud יש שם פרויקט, מזהה פרויקט ומספר פרויקט. לפעמים צריך את המזהים האלה כדי להגדיר שירותים או להשלים משימות אחרות.

כדי לגלות את המזהה והמספר של הפרויקט הרגיל:

1. פותחים את פרויקט Cloud.
2. בפינה השמאלית העליונה, לוחצים על סמל האפשרויות הנוספות more_vert > הגדרות הפרויקט.
3. לוח ההגדרות שיוצג יכלול את שם הפרויקט, מזהה הפרויקט ומספר הפרויקט. מספר הפרויקט מכיל רק ספרות, ואילו מזהה הפרויקט מכיל אותיות וספרות. אתם יכולים לערוך את שם הפרויקט שמוצג למשתמשים בהנחיות לאישור הרשאה.

הצגת יומנים ודוחות שגיאות של Google Cloud במסוף Google Cloud

אם אתם משתמשים ברישום ביומן של Google Cloud או בדיווח על שגיאות בפרויקט שלכם ב-Apps Script, תוכלו לראות את היומנים והדוחות האלה במסוף Google Cloud באופן הבא:

1. פותחים את פרויקט Cloud.
2. לוחצים על סמל התפריט menu.
3. גוללים למטה לקטע Operations ולוחצים על Logging > Logs explorer.
4. כדי לראות את דוחות השגיאות, גוללים למטה לקטע פעולות ולוחצים על דיווח על שגיאות. אם מוצגת לכם בקשה להגדיר דיווח על שגיאות, זה אומר שעדיין לא נרשמו חריגים בפרויקט הסקריפט.

השלמת מסך ההסכמה של OAuth

כשמשתמשים בשירותים שדורשים OAuth, ‏ Google מבקשת מהמשתמשים לאשר את השירותים האלה. בהגדרות של מסך ההסכמה של OAuth אפשר להגדיר חלק מהמידע ש-Google מציגה למשתמשים, כמו שם האפליקציה וכתובת ה-URL של התנאים וההגבלות.

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

1. פותחים את פרויקט Cloud.
2. לוחצים על סמל התפריט menu > APIs & Services > Credentials.
3. לוחצים על הגדרת מסך ההסכמה.
4. ממלאים כל חלק בתהליך העבודה של מסך בקשת ההסכמה.
5. כדי לתעד את השינויים בכל שלב בתהליך העבודה, לוחצים על שמירה והמשך.

יצירת פרטי כניסה של OAuth

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

כדי ליצור מזהה לקוח וסוד לקוח לפרויקט הסקריפט, צריך לבצע את הפעולות הבאות:

1. פותחים את פרויקט Cloud.
2. לוחצים על סמל התפריט menu > APIs & Services > Credentials.
3. לוחצים על Create credentials > OAuth client ID.
4. בקטע Application type, בוחרים את סוג האפליקציה וממלאים את הטופס שמופיע אם צריך. בסיום, לוחצים על יצירה.
5. בתיבת הדו-שיח שמופיעה, לוחצים על Download JSON. אפשר להשתמש בקובץ הזה כדי להגדיר את OAuth.

הוספת בעלים נוספים לפרויקט רגיל ב-Cloud

אתם יכולים להוסיף בעלים נוספים או תפקידים אחרים לפרויקט רגיל. אם אתם משתפים פעולה בפרויקט, כך תוכלו להבטיח שלמישהו בצוות תמיד תהיה גישה להגדרות Google Cloud של פרויקט הסקריפט.

כדי להוסיף בעלים נוספים או תפקידים אחרים לפרויקט רגיל, צריך לבצע את השלבים הבאים. כדי לבצע שינויים בפרויקט, נדרשות הרשאות עריכה. השינויים האפשריים הם:

1. קובעים מי יהיו שותפי העריכה. מומלץ ליצור קבוצת Google או להשתמש בקבוצה קיימת. אפשר גם לציין דומיינים ברשימת בעלי ההרשאה כדי לכלול את כל המשתמשים בדומיין הזה.
2. פותחים את פרויקט Cloud של הסקריפט.
3. לוחצים על סמל התפריט menu > IAM & admin > IAM.
4. למעלה, לוחצים על הוספה.
5. פועלים לפי ההוראות במסך כדי להוסיף חברים חדשים ואת התפקידים שלהם בפרויקט Cloud. אפשר להוסיף כתובות אימייל נפרדות, קבוצות Google או דומיינים כחברים חדשים.
6. לוחצים על שמירה.

קיבוץ של כמה סקריפטים בפרויקט Cloud אחד

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

שימוש בפרויקט אחר רגיל ב-Cloud

אפשר להחליף פרויקט של סקריפט כך שישתמש בפרויקט Cloud רגיל אחר. אם הסקריפט שלכם דורש הגדרה ידנית של פרויקט Cloud, אתם צריכים לעבור מפרויקט ברירת מחדל לפרויקט רגיל. מידע נוסף על המקרים שבהם צריך להשתמש בפרויקט רגיל זמין במאמר בנושא פרויקטים רגילים ב-Cloud.

ההשפעות של מעבר לפרויקט אחר בענן בתקן

אם מעבירים סקריפט מפרויקט ברירת מחדל או לפרויקט רגיל אחר, מתרחשים השינויים הבאים:

• אם הפעלתם שירותים מתקדמים בסקריפט, אתם צריכים להפעיל את ממשקי ה-API המתאימים בפרויקט החדש ב-Cloud. כל הנתונים שקשורים לשירותים המתקדמים בפרויקט הקודם ב-Cloud יאבדו. כאן אפשר לקרוא איך להפעיל ממשקי API בפרויקט בענן.
• אם התסריט שלכם משתמש בשירות המובנה של Google Drive, אתם צריכים להפעיל את Drive API בפרויקטים רגילים ב-Cloud.

  בפרויקט הרגיל שלכם ב-Cloud, מפעילים את Drive API:

  הפעלת Drive API

• כל המשתמשים שאישרו בעבר את הסקריפט צריכים לאשר אותו מחדש. ברוב המקרים, כל המשתמשים שאישרו בעבר אפליקציות שמשויכות לפרויקט החדש צריכים לאשר אותן מחדש.
• אם הסקריפט משויך לדף אפליקציה ב-Google Workspace Marketplace, דף האפליקציה, המשתמשים והביקורות לא יועברו לפרויקט החדש. צריך ליצור דף אפליקציה חדש בפרויקט החדש, והמשתמשים יצטרכו להתקין מחדש את האפליקציה. מידע על יצירת דף אפליקציה חדש זמין במאמר פרסום אפליקציה.
• אי אפשר להחזיר סקריפט לפרויקט ברירת מחדל. ‫Apps Script מוחק פרויקטים שמוגדרים כברירת מחדל אחרי שמגדירים את הסקריפט לשימוש בפרויקט רגיל.

מעבר לפרויקט אחר רגיל ב-Cloud

כדי להעביר פרויקט Cloud קיים שמשויך לסקריפט לפרויקט Cloud אחר, פועלים לפי השלבים הבאים:

1. אם אין לכם פרויקט מתאים בענן, אתם יכולים ליצור אחד לפי ההוראות שבמאמר יצירת פרויקט. מומלץ לבחור שם פרויקט שקל לזכור, כדי שתוכלו למצוא אותו בדף Manage Resources (ניהול משאבים) במסוף Google Cloud. השם הזה משמש את Apps Script כשמבקשים מהמשתמשים לאשר את הסקריפט.
2. אם רוצים להשתמש בפרויקט קיים, פותחים את הדף ניהול משאבים במסוף Google Cloud ומאתרים פרויקט קיים שרוצים להשתמש בו. צריכות להיות לכם הרשאות של התפקידים Project Browser ו-OAuth Config Editor, או הרשאות שוות ערך, בפרויקט. אי אפשר להשתמש בפרויקט שנוצר באופן אוטומטי על ידי Apps Script.
3. קובעים את מספר הפרויקט של הפרויקט ב-Cloud.
4. פותחים את הסקריפט שרוצים להחליף את פרויקט הענן שלו.
5. בצד ימין, לוחצים על הגדרות הפרויקט settings.
6. בקטע פרויקט Google Cloud Platform (GCP)‎, לוחצים על שינוי הפרויקט.
7. מזינים את מספר הפרויקט החדש ולוחצים על הגדרת פרויקט.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID