מכסות לשירותי Google

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

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

מכסות נוכחיות

ההקצאות מוגדרות ברמות שונות למשתמשים בחשבונות פרטיים (כמו gmail.com) או בחשבונות של מהדורת G Suite החינמית (שלא זמינה יותר) ולמשתמשים בחשבונות Google Workspace. המכסות הן לכל משתמש והן מתאפסות 24 שעות אחרי הבקשה הראשונה.

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

תכונה צרכני (למשל, gmail.com) ו
מהדורת G Suite החינמית
(מהדורת חינמית מדור קודם) 		חשבונות Google Workspace
אירועי יומן שאפשר ליצור ‫5,000 ביום ‫10,000 ביום
אנשי קשר שאפשר ליצור ‫1,000 ביום ‫2,000 ביום
מסמכים שנוצרו ‫250 ביום ‫1,500 ביום
קבצים שהומרו ‫2,000 ביום ‫4,000 ביום
נמעני אימייל ביום (לדוגמה, עם MailApp) ‫100* ליום ‫1,500* ליום
נמעני אימייל ביום בתוך הדומיין (לדוגמה, עם MailApp) ‫100* ליום ‫2,000 ביום
קריאה וכתיבה של אימיילים (לא כולל שליחה) ‫20,000 ביום ‫50,000 ביום
קריאות לקבוצות ‫2,000 ביום ‫10,000 ביום
חיבור JDBC ‫10,000 ביום ‫50,000 ביום
חיבור JDBC כושל ‫100 ביום ‫500 ביום
מצגות נוצרו ‫250 ביום ‫1,500 ביום
מאפיינים לקריאה/כתיבה ‫50,000 ביום ‫500,000 ביום
שקפים שנוצרו ‫250 ביום ‫1,500 ביום
גיליונות אלקטרוניים שאפשר ליצור ‫250 ביום ‫3,200 ביום
זמן ריצה כולל של מפעילים (Triggers) ‫90 דקות ביום 6 שעות ביום
קריאות לשליפת כתובת אתר ‫20,000 ביום ‫100,000 ביום
עיבוד של מפה סטטית ‫1,000 ביום ‫10,000 ביום
שאילתה לקבלת מסלול במפות Google ‫1,000 ביום ‫10,000 ביום
קריאות ל-Geocode במפות Google ‫1,000 ביום ‫10,000 ביום
תרגום שיחות ‫5,000 ביום ‫20,000 ביום
שאילתה לדוגמאות של גובה במפות Google ‫1,000 ביום ‫10,000 ביום
פרויקטים של Apps Script ‫50 ביום ‫50 ביום

מגבלות נוכחיות

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

תכונה צרכני (למשל, gmail.com) ו
מהדורת G Suite החינמית
(מהדורת חינמית מדור קודם) 		חשבונות Google Workspace
זמן ריצה של סקריפט ‫6 דקות / הרצה ‫6 דקות / הרצה
זמן ריצה של פונקציה מותאמת אישית ‫30 שניות / הפעלה ‫30 שניות / הפעלה
זמן ריצה של תוסף ל-Google Workspace ‫30 שניות / הפעלה ‫30 שניות* / הפעלה
הפעלות בו-זמניות לכל משתמש ‫30 למשתמש ‫30 למשתמש
הפעלות בו-זמניות לכל סקריפט 1,000 1,000
קבצים מצורפים לאימייל ‫250 / הודעה ‫250 / הודעה
גודל הגוף של הודעת האימייל ‫200KB / הודעה ‫400KB / הודעה
נמענים להודעת אימייל ‫50 / הודעה ‫50 / הודעה
גודל כולל של קבצים מצורפים להודעת אימייל ‫25MB / הודעה ‫25MB / הודעה
גודל הערך של מאפיינים ‫9KB / ערך ‫9KB / ערך
נפח האחסון הכולל של הנכסים ‫500KB לכל חנות בנכס ‫500KB לכל חנות בנכס
טריגרים ‫20 לכל משתמש לכל סקריפט ‫20 לכל משתמש לכל סקריפט
גודל התגובה של אחזור כתובת URL ‫50MB לכל שיחה ‫50MB לכל שיחה
כותרות ב-URL Fetch ‫100 / שיחה ‫100 / שיחה
גודל כותרת ב-URL Fetch ‫8KB לכל שיחה ‫8KB לכל שיחה
גודל פוסט ב-URLFetch ‫50MB לכל שיחה ‫50MB לכל שיחה
אורך כתובת URL ב-URL Fetch ‫2KB לכל שיחה ‫2KB לכל שיחה
גרסאות ‫200 / script ‫200 / script

מעקב אחרי השימוש במכסה

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

  • מכסת אימייל: אפשר להשתמש בפקודה MailApp.getRemainingDailyQuota() כדי לבדוק את מספר הנמענים שנותרו שאפשר לשלוח להם אימייל עד סוף היום.
  • מעקב אחר ביצועים: אפשר להשתמש בלוח הבקרה של Apps Script כדי לראות את היסטוריית הביצועים והתקינות של הסקריפט. בדף ההרצות שלי מוצג הסטטוס (לדוגמה, Completed, Failed או Running) של כל הרצת תסריט. אפשר לעקוב אחרי מספר ההפעלות בו-זמנית באמצעות סינון של הפעלות עם סטטוס של Running.
  • מסוף Google Cloud: אם פרויקט Apps Script שלכם משתמש בפרויקט רגיל ב-Google Cloud, תוכלו לעקוב אחרי המכסות הספציפיות לשירות והשימוש בממשקי ה-API במסוף Google Cloud.

הודעות על חריגים

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

  • ‫Limit exceeded: Email Attachments Per Message. מציין שהסקריפט חרג מאחת מהמכסות או מהמגבלות שצוינו למעלה.
  • Service invoked too many times: Calendar. המשמעות היא שהסקריפט קרא לשירות הנתון יותר מדי פעמים ביום אחד.
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. המשמעות היא שהסקריפט קרא לשירות הנתון יותר מדי פעמים בפרק זמן קצר.
  • Service using too much computer time for one day. המשמעות היא שהסקריפט חרג ממגבלת זמן הביצוע הכוללת המותרת ליום אחד. השגיאה הזו מתרחשת בדרך כלל בסקריפטים שמופעלים על ידי טריגר, שיש להם מגבלה יומית נמוכה יותר מאשר בסקריפטים שמופעלים באופן ידני.
  • Script invoked too many times per second for this Google user account. השגיאה הזו מציינת שהסקריפט התחיל לפעול יותר מדי פעמים בפרק זמן קצר. השגיאה הזו מתרחשת בדרך כלל בפונקציות בהתאמה אישית שמופעלות שוב ושוב בגיליון אלקטרוני יחיד. כדי למנוע את השגיאה הזו, צריך לתכנת את הפונקציות המותאמות אישית כך שיהיה צורך להפעיל אותן רק פעם אחת לכל טווח נתונים, כמו שמוסבר במדריך לפונקציות מותאמות אישית.
  • There are too many scripts running simultaneously for this Google user account. המשמעות היא שיש יותר מדי סקריפטים שמופעלים בו-זמנית, אבל לא בהכרח אותו סקריפט. בדומה לחריג שלמעלה, זה קורה בדרך כלל בפונקציות מותאמות אישית שמופעלות שוב ושוב בגיליון אלקטרוני יחיד.