פרויקטים ב-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) (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

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

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

הצגה של יומני 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. לוחצים על סמל התפריט > ממשקי API ו- Services (שירותים) > פרטי כניסה.
  3. לוחצים על Configure consent screen.
  4. ממלאים כל קטע בתהליך העבודה של מסך ההסכמה.
  5. כדי לתעד את השינויים בכל שלב בתהליך העבודה, לוחצים על שמירה והמשך.

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

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

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

  1. פותחים את הפרויקט ב-Cloud.
  2. לוחצים על סמל התפריט > ממשקי API ו- Services (שירותים) > פרטי כניסה.
  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

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

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

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

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

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

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

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

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

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

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

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