سرویسهای اسکریپت Google Apps دارای سهمیهها و محدودیتهای روزانه برای برخی از ویژگیها هستند. اگر از سهمیه یا محدودیت تعیینشده تجاوز کنید، اسکریپت شما یک استثنا ایجاد میکند و اجرا متوقف میشود.
برخی از ویژگیها سهمیههای اضافی از محصول گوگل مرتبط با خود دارند. استفاده از سرویس Apps Script یک محصول، جزو تمام ذخایر سهمیه مرتبط محسوب میشود. اگر به هر یک از سهمیههای مرتبط برسید، یک ویژگی از دسترس خارج میشود.
سهمیههای فعلی
سهمیهها در سطوح مختلف برای کاربران حسابهای کاربری مصرفی (مانند gmail.com) و حسابهای Google Workspace تعیین میشوند. سهمیهها به ازای هر کاربر هستند و ۲۴ ساعت پس از اولین درخواست، بازنشانی میشوند.
از سهمیههای زیر برای آزمایش اسکریپتهای خود استفاده کنید. همه سهمیهها در هر زمان و بدون اطلاع قبلی قابل حذف، کاهش یا تغییر هستند.
| ویژگی | حسابهای کاربری مصرفکننده (برای مثال، gmail.com) | فضای کاری گوگل حسابها |
|---|---|---|
| رویدادهای تقویم ایجاد شده | ۵۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| مخاطبین ایجاد شدند | ۱۰۰۰ در روز | ۲۰۰۰ در روز |
| اسناد ایجاد شده | ۲۵۰ در روز | ۱۵۰۰ در روز |
| فایلهای تبدیلشده | ۲۰۰۰ در روز | ۴۰۰۰ در روز |
| تعداد دریافتکنندگان ایمیل در هر روز (برای مثال، با MailApp) | ۱۰۰ * در روز | ۱۵۰۰ * در روز |
| تعداد دریافتکنندگان ایمیل در هر روز در یک دامنه (برای مثال، با MailApp) | ۱۰۰ * در روز | ۲۰۰۰ در روز |
| خواندن/نوشتن ایمیل (به جز ارسال) | ۲۰،۰۰۰ در روز | ۵۰،۰۰۰ در روز |
| گروهها میخوانند | ۲۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| اتصال JDBC | ۱۰،۰۰۰ در روز | ۵۰،۰۰۰ در روز |
| اتصال JDBC ناموفق بود | ۱۰۰ در روز | ۵۰۰ در روز |
| ارائههای ایجاد شده | ۲۵۰ در روز | ۱۵۰۰ در روز |
| خواص خواندنی/نوشتنی | ۵۰،۰۰۰ در روز | ۵۰۰۰۰۰ در روز |
| اسلایدهای ایجاد شده | ۲۵۰ در روز | ۱۵۰۰ در روز |
| صفحات گسترده ایجاد شده | ۲۵۰ در روز | ۳۲۰۰ در روز |
| کل زمان اجرا را فعال میکند. | ۹۰ دقیقه در روز | ۶ ساعت در روز |
| فراخوانیهای واکشی URL | ۲۰،۰۰۰ در روز | ۱۰۰۰۰۰ در روز |
| رندر نقشه استاتیک | ۱۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| جستجوی مسیر در گوگل مپ | ۱۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| تماسهای ژئوکد نقشه گوگل | ۱۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| ترجمه تماسها | ۵۰۰۰ در روز | ۲۰،۰۰۰ در روز |
| جستجوی نمونههای ارتفاعی نقشه گوگل | ۱۰۰۰ در روز | ۱۰،۰۰۰ در روز |
| پروژههای اسکریپت برنامهها | ۵۰ عدد در روز | ۵۰ عدد در روز |
محدودیتهای اضافی برای حسابهای آزمایشی اعمال میشود. پس از تبدیل حساب آزمایشی رایگان به اشتراک پولی، در صورت وجود هر دو مورد زیر، محدودیتهای حساب شما به طور خودکار افزایش مییابد:
- دامنه شما در مجموع حداقل ۱۰۰ دلار آمریکا (یا معادل آن) پرداخت کرده است.
- حداقل ۶۰ روز از رسیدن به آن آستانه پرداخت گذشته باشد.
محدودیتهای فعلی
از محدودیتهای زیر برای آزمایش اسکریپتهای خود استفاده کنید. همه محدودیتها در هر زمان و بدون اطلاع قبلی قابل حذف، کاهش یا تغییر هستند.
| ویژگی | حسابهای کاربری مصرفکننده (مثلاً gmail.com) | فضای کاری گوگل حسابها |
|---|---|---|
| زمان اجرای اسکریپت | ۶ دقیقه / اجرا | ۶ دقیقه / اجرا |
| زمان اجرای تابع سفارشی | ۳۰ ثانیه / اجرا | ۳۰ ثانیه / اجرا |
| زمان اجرای افزونهی Google Workspace | ۳۰ ثانیه / اجرا | 30 ثانیه * / اجرا |
| اجرای همزمان برای هر کاربر | 30 / کاربر | 30 / کاربر |
| اجراهای همزمان به ازای هر اسکریپت | ۱۰۰۰ | ۱۰۰۰ |
| پیوستهای ایمیل | ۲۵۰ / پیامک | ۲۵۰ / پیامک |
| اندازه بدنه ایمیل | ۲۰۰ کیلوبایت در هر پیامک | ۴۰۰ کیلوبایت در هر پیامک |
| گیرندگان ایمیل در هر پیام | 50 / پیام | 50 / پیام |
| حجم کل پیوستهای ایمیل | ۲۵ مگابایت در هر پیامک | ۲۵ مگابایت در هر پیامک |
| اندازه مقدار ویژگیها | ۹ کیلوبایت بر لیتر | ۹ کیلوبایت بر لیتر |
| کل فضای ذخیرهسازی ویژگیها | ۵۰۰ کیلوبایت / فروشگاه املاک | ۵۰۰ کیلوبایت / فروشگاه املاک |
| محرکها | ۲۰ / کاربر / اسکریپت | ۲۰ / کاربر / اسکریپت |
| اندازه پاسخ واکشی URL | ۵۰ مگابایت / مکالمه | ۵۰ مگابایت / مکالمه |
| هدرهای واکشی URL | ۱۰۰ / تماس بگیرید | ۱۰۰ / تماس بگیرید |
| اندازه هدر دریافت URL | ۸ کیلوبایت / تماس | ۸ کیلوبایت / تماس |
| اندازه پست دریافت URL | ۵۰ مگابایت / مکالمه | ۵۰ مگابایت / مکالمه |
| طول URL برای دریافت URL | ۲ کیلوبایت / تماس | ۲ کیلوبایت / تماس |
| نسخهها | ۲۰۰ / اسکریپت | ۲۰۰ / اسکریپت |
نظارت بر استفاده از سهمیه
برای نظارت بر مصرف سهمیه و سلامت اجرای اسکریپت خود، از روشهای زیر استفاده کنید:
- سهمیه ایمیل : از
MailApp.getRemainingDailyQuota()برای بررسی تعداد گیرندگان ایمیل باقی مانده که میتوانید برای بقیه روز به آنها ایمیل ارسال کنید، استفاده کنید. - نظارت بر اجرا : از داشبورد Apps Script برای مشاهده سابقه اجرا و سلامت اسکریپت خود استفاده کنید. صفحه My Executions وضعیت (مثلاً
Completed،FailedیاRunning) هر اجرای اسکریپت را نشان میدهد. میتوانید با فیلتر کردن اجراها با وضعیتRunning، تعداد اجراهای همزمان را نظارت کنید. - کنسول گوگل کلود : اگر پروژه Apps Script شما از یک پروژه استاندارد گوگل کلود استفاده میکند، میتوانید سهمیههای خاص سرویس و میزان استفاده از API را در کنسول گوگل کلود رصد کنید.
پیامهای استثنا
اگر یک اسکریپت به سهمیه یا محدودیتی برسد، یک استثنا با پیامی مشابه پیام زیر ایجاد میکند:
-
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.این نشان میدهد که اسکریپت از کل زمان اجرای مجاز برای یک روز فراتر رفته است. این اتفاق معمولاً برای اسکریپتهایی رخ میدهد که با یک trigger اجرا میشوند و محدودیت روزانه کمتری نسبت به اسکریپتهایی که به صورت دستی اجرا میشوند، دارند. -
Script invoked too many times per second for this Google user account.این نشان میدهد که اسکریپت در مدت زمان کوتاهی بیش از حد شروع به اجرا کرده است. این خطا معمولاً برای توابع سفارشی که به طور مکرر در یک صفحه گسترده فراخوانی میشوند، رخ میدهد. برای جلوگیری از این خطا، توابع سفارشی خود را طوری کدنویسی کنید که فقط یک بار در هر محدوده از دادهها فراخوانی شوند، همانطور که در راهنمای توابع سفارشی توضیح داده شده است. -
There are too many scripts running simultaneously for this Google user account.این نشان میدهد که شما اسکریپتهای زیادی را به طور همزمان اجرا میکنید، اگرچه لزوماً اسکریپت یکسانی نیستند. مانند استثنای قبلی، این مورد معمولاً برای توابع سفارشی که به طور مکرر در یک صفحه گسترده فراخوانی میشوند، رخ میدهد.