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

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

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

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

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

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

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

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

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

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

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

מתי ב-Apps Script צריך פרויקטים רגילים בענן

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

מאפייני פרויקט Standard Cloud

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

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

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

כדי לגשת לפרויקט הרגיל שמשויך לפרויקט הסקריפט:

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

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

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

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

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

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

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

    בפרויקט 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. לוחצים על מסנן > מזהה הורה ומדביקים את מזהה התיקייה ב-Apps Script.

מחיקת פרויקטים ב-Apps Script בענן

כדי למחוק פרויקט ב-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 זמין במאמר כיבוי (מחיקה) של פרויקטים.