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

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

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

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

כשיוצרים פרויקט ב-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].

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

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

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

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

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

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

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

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

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

  1. פותחים את הפרויקט ב-Cloud.
  2. לוחצים על סמל התפריט .
  3. גוללים למטה לקטע Operations ולוחצים על Logging > Logs explorer.
  4. כדי להציג דוחות שגיאות, גוללים למטה לקטע Operations ולוחצים על 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 לשירותים שבהם ה-Script משתמש. באפליקציות מסוימות צריך ליצור פרטי כניסה נוספים ל-OAuth (מזהי לקוחות וסודות לקוח). אפשר לעשות זאת רק בפרויקטים רגילים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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