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

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

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

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

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

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

גישה לפרויקט רגיל בענן

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

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

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

הפעלת API בפרויקט בענן רגיל

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי ליצור מזהה לקוח וסוד לקוח לפרויקט הסקריפט:

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

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

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

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

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

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

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

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

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

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

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

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

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

    הפעלת Drive API

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

מעבר לפרויקט בענן אחר רגיל

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

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

פרויקטים בענן ותיקיות אחסון שיתופי

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

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

  • אם פרויקט הסקריפט שלכם משתמש בפרויקט רגיל, אין הגבלות נוספות כשפרויקט הסקריפט נמצא באחסון שיתופי.
  • אם פרויקט הסקריפט שלכם משתמש בפרויקט ברירת מחדל שנוצר בתאריך 8 באפריל 2019 או אחריו, לא חלות הגבלות נוספות כשפרויקט הסקריפט נמצא באחסון שיתופי.
  • אם פרויקט הסקריפט שלכם משתמש בפרויקט ברירת מחדל שנוצר לפני 8 באפריל 2019, ההגבלות הבאות חלות בזמן שפרויקט הסקריפט נמצא באחסון שיתופי:
    1. אי אפשר לגשת לפרויקט שמוגדר כברירת מחדל באמצעות ממשק המשתמש של Apps Script או מסוף Google Cloud. ההגבלה הזו מונעת מכם לבצע פעולות שמחייבות גישה ישירה לפרויקט.
    2. אי אפשר להפעיל שירותים מתקדמים. כדי להפעיל שירותים מתקדמים, צריך לעבור לפרויקט רגיל.
    3. כשמעבירים פרויקט קיים ב-Apps Script לאחסון שיתופי, Google מגבילה את הגישה לפרויקט בענן שמוגדר כברירת מחדל. אם הייתה לכם גישה לפרויקט ברירת המחדל לפני ההעברה, תוכלו עדיין לגשת אליו. לדוגמה, אם יצרתם סקריפט בתיקייה 'האחסון שלי' ואז העברתם אותו לאחסון שיתופי, עדיין תוכלו לגשת לפרויקט בענן של הסקריפט. יכול להיות ששותפי העריכה באחסון השיתופי לא יוכלו לעשות זאת.
    4. סקריפט שומר על שם פרויקט בענן שהיה לו לפני שהועבר לאחסון שיתופי. גם אם תשנו את שם הפרויקט באחסון השיתופי, המשתמשים שמאשרים את התסריט עדיין יראו את השם הישן בתיבות הדו-שיח של ההרשאות.

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

קבלת רשימה של פרויקטים ב-Cloud ב-Apps Script

אם יש לכם את ההרשאה resourcemanager.projects.list לתיקיית הפרויקטים ב-Apps Script של הארגון, תוכלו לראות את כל הפרויקטים הרגילים והמוגדרים כברירת מחדל ב-Apps Script Cloud בתוך התיקייה.

  1. פותחים את מסוף Google Cloud Manage Resources page.
  2. לצד התיקייה Apps Script, מעתיקים את המזהה.
  3. לוחצים על מסנן > מזהה תיקיית הורה ומדביקים את מזהה התיקייה של Apps Script.

מחיקת פרויקטים ב-Cloud ב-Apps Script

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

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

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

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