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

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

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

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

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

הצגת יומנים ודוחות שגיאות של 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. לוחצים על הוספה בחלק העליון.
  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. בצד ימין, לוחצים על הגדרות הפרויקט .
  6. בקטע פרויקט Google Cloud Platform (GCP), לוחצים על שינוי פרויקט.
  7. מזינים את מספר הפרויקט החדש ולוחצים על Set project.

פרויקטים ב-Cloud ואחסון שיתופי

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

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

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

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

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

אם יש לכם את ההרשאה 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

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

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

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

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