פרויקטים ב-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 הוא appsdev-apps-dev-script-auth@system.gserviceaccount.com.

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

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

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

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

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

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

  • אם מוחקים את פרויקט הסקריפט או מעבירים אותו לשימוש בפרויקט רגיל, Apps Script מוחק את פרויקט ברירת המחדל שמצורף לסקריפט יחד עם כל ההגדרות או המידע שהוא מכיל.
  • אם סקריפט לא פועל במשך 180 יום או יותר, Apps Script מוחק את פרויקט ברירת המחדל המשויך אליו. אם הסקריפט רץ אחרי ש-Apps Script מוחק את פרויקט ברירת המחדל שלו, Apps Script יוצר אותו עבור הסקריפט.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

קביעת המזהה והמספר של פרויקט סטנדרטי ב-Cloud

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

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

  1. פותחים את הפרויקט ב-Cloud.
  2. בפינה השמאלית העליונה לוחצים על סמל האפשרויות הנוספות > Project settings.
  3. בודקים את השדות Project name, Project ID ו-Project number בחלונית Settings שמתקבלת. השדה Project number מורכב מספרות בלבד, ואילו Project ID כולל אותיות וספרות. אפשר לערוך את Project name – שמוצג למשתמשים כשמוצגות בקשה להרשאות.

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

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

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

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

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

  1. פותחים את הפרויקט ב-Cloud.
  2. לוחצים על סמל התפריט > APIs & Services > Credentials.
  3. לוחצים על Configure consent screen.
  4. ממלאים כל קטע בתהליך העבודה של מסך ההסכמה.
  5. כדי לתעד את השינויים בכל שלב בתהליך העבודה, לוחצים על Save and continue (שמירה והמשך).

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

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

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

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

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

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

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

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

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

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

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

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

ההשלכות של המעבר לפרויקט רגיל אחר ב-Cloud

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

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

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

    הפעלת Drive API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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