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

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

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

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

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

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

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

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

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

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

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

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

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

  • גישה ישירה לכל ההגדרות של הפרויקט ב-Google Cloud ממסוף Google Cloud. כך תוכלו להפעיל ממשקי API, לשנות את פרטי הכניסה להרשאה ולהגדיר פרטים אחרים.
  • כשמוחקים פרויקט סקריפט או מעבירים אותו אל משתמשים בפרויקט רגיל אחר, הפרויקט הרגיל המקורי נשאר ויכול להיות שנעשה בו שימוש חוזר.
  • כשמפעילים שירות מתקדם בפרויקט של סקריפט, עליך להפעיל באופן ידני את ה-API התואם של פרויקט רגיל.
  • אפשר לחלוק מספר פרויקטים של סקריפטים ואפליקציות אחרות של פרויקט רגיל. אם אתם מתכוונים לפרסם פרויקט סקריפט ל Google Workspace Marketplace בתור תוסף, צריך להיות לו פרויקט רגיל משלו. אי אפשר לשתף אפליקציות שפורסמו פרויקטים בענן עם אפליקציות אחרות.
  • אם רוצים להריץ פונקציות בפרויקט סקריפט מאפליקציה אחרת באמצעות השיטה 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. לוחצים על סמל התפריט > ממשקי API ו- שירותים.
  3. לוחצים על Enable APIs and Services.
  4. בתיבת החיפוש, מזינים את ממשק ה-API שרוצים להפעיל ומקישים על Enter.
  5. לוחצים על ה-API בתוצאות החיפוש ואז לוחצים על Enable כדי להפעיל את ה-API של הפרויקט הזה ב-Cloud.

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

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

מאתרים את המזהה מספר פרויקט סטנדרטי ב-Cloud.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי למחוק פרויקט ב-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

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