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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בפרויקטים של Cloud שמוגדרים כברירת מחדל, מסך ההסכמה נוצר באופן אוטומטי מפרטי הפרויקט ב-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 יכולים לחלוק את אותו פרויקט בענן רגיל. כדי לעשות את זה, יוצרים פרויקט רגיל ואז מעבירים כל פרויקט של סקריפט לשימוש בו. אי אפשר לעשות את זה עם פרויקטים שמוגדרים כברירת מחדל.

אם רוצים לפרסם את פרויקט הסקריפט ב-Marketplace כתוסף, הוא צריך להיות פרויקט סטנדרטי משלו – אפליקציות שפורסמו לא יכולות לשתף פרויקטים ב-Cloud.

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

העברה של פרויקט סקריפט לשימוש בפרויקט בענן רגיל אחר. אם הסקריפט דורש הגדרה ידנית של פרויקט בענן, צריך לעבור מפרויקט ברירת מחדל לפרויקט רגיל. מידע נוסף זמין במאמר בנושא פרויקטים רגילים ב-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. אם רוצים להשתמש בפרויקט קיים, פותחים את הדף ניהול משאבים במסוף Google Cloud ומאתרים פרויקט קיים שרוצים להשתמש בו. צריכות להיות לכם הרשאות של התפקידים Project Browser ו-OAuth Config Editor, או הרשאות שוות ערך, בפרויקט. אי אפשר להשתמש בפרויקט שנוצר באופן אוטומטי על ידי Apps Script.
  3. מגלים את מספר הפרויקט של פרויקט בענן.
  4. פותחים את הסקריפט שרוצים להחליף את פרויקט הענן שלו.
  5. בצד ימין, לוחצים על הגדרות הפרויקט .
  6. בקטע פרויקט ב-Google Cloud, לוחצים על שינוי הפרויקט.
  7. מזינים את מספר הפרויקט החדש ולוחצים על הגדרת פרויקט.

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

תיקיות משותפות זמינות רק ללקוחות Google Workspace Business ו-Google Workspace Enterprise.

אחסון שיתופי (לשעבר 'אחסון צוותי') מספק סביבות משותפות שבהן קבוצות של משתמשי 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. לוחצים על Filter (מסנן) > Parent ID (מזהה תיקיית האב) ומדביקים את מזהה התיקייה של Apps Script.

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

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

כדי למחוק פרויקט Apps Script ממסוף Google Cloud:

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

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

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

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