تفرض خدمات 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 في اليوم |
| مستلمو البريد الإلكتروني لكل يوم | 100* في اليوم | 1,500* في اليوم |
| مستلمو الرسائل الإلكترونية في اليوم ضمن النطاق | 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 في اليوم |
| إجمالي وقت التشغيل للعوامل المشغلة | 90 دقيقة في اليوم | 6 ساعات في اليوم |
| استدعاءات إحضار بيانات من عنوان URL | 20,000 في اليوم | 100,000 في اليوم |
| عرض الخريطة الثابتة | 1,000 في اليوم | 10,000 في اليوم |
| طلب الحصول على الاتجاهات في "خرائط Google" | 1,000 في اليوم | 10,000 في اليوم |
| طلبات ترميز المواقع الجغرافية في "خرائط Google" | 1,000 في اليوم | 10,000 في اليوم |
| ترجمة المكالمات | 5,000 في اليوم | 20,000 في اليوم |
| طلب البحث عن عيّنات الارتفاع في "خرائط Google" | 1,000 في اليوم | 10,000 في اليوم |
| مشاريع "برمجة تطبيقات Google" | 50 / يوم | 50 / يوم |
القيود الحالية
استخدِم الحدود الواردة أدناه للمساعدة في اختبار النصوص البرمجية. جميع الحدود هي خاضعة للإزالة أو الخفض أو التغيير في أي وقت بدون إشعار.
| الميزة | حساب المستهلك (مثل gmail.com) و الإصدار المجاني من G Suite (القديم) |
حسابات Google Workspace |
|---|---|---|
| وقت تشغيل النص البرمجي | 6 دقائق لكل عملية تنفيذ | 6 دقائق لكل عملية تنفيذ |
| وقت تشغيل الدالة المخصّصة | 30 ثانية لكلّ تنفيذ | 30 ثانية لكلّ تنفيذ |
| وقت تشغيل إضافة Google Workspace | 30 ثانية لكلّ تنفيذ | 30 ثانية لكلّ تنفيذ |
| عمليات التنفيذ المتزامنة لكل مستخدم | 30 لكل مستخدم | 30 لكل مستخدم |
| عمليات التنفيذ المتزامنة لكل نص برمجي | 1,000 | 1,000 |
| مرفقات الرسائل الإلكترونية | 250 / رسالة | 250 / رسالة |
| حجم نص البريد الإلكتروني | 200 كيلوبايت / رسالة | 400 كيلوبايت / رسالة |
| مستلمو الرسائل الإلكترونية لكل رسالة | 50 / رسالة | 50 / رسالة |
| إجمالي حجم مرفقات البريد الإلكتروني | 25 ميغابايت / رسالة | 25 ميغابايت / رسالة |
| حجم قيم السمات | 9 كيلوبايت لكل قيمة | 9 كيلوبايت لكل قيمة |
| إجمالي مساحة التخزين في المواقع | 500 كيلوبايت لكل متجر على الموقع | 500 كيلوبايت لكل متجر على الموقع |
| العوامل التي تؤدي إلى الظهور | 20 / مستخدم / نص برمجي | 20 / مستخدم / نص برمجي |
| حجم استجابة URL Fetch | 50 ميغابايت لكل مكالمة | 50 ميغابايت لكل مكالمة |
| عناوين URL Fetch | 100 لكل مكالمة | 100 لكل مكالمة |
| حجم عنوان URL Fetch | 8 كيلوبايت / مكالمة | 8 كيلوبايت / مكالمة |
| حجم مشاركة URL Fetch | 50 ميغابايت لكل مكالمة | 50 ميغابايت لكل مكالمة |
| طول عنوان URL في URL Fetch | 2 كيلوبايت لكل مكالمة | 2 كيلوبايت لكل مكالمة |
| الإصدارات | 200 / نص | 200 / نص |
رسائل الاستثناء
إذا بلغ نص برمجي حصة أو حدًا أقصى، يُرسِل استثناءً يحتوي على رسالة مشابهة لما يلي:
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.يشير ذلك إلى أنّ لديك عددًا كبيرًا جدًا من النصوص البرمجية التي يتم تنفيذها في آنٍ واحد، ولكن ليس بالضرورة النص البرمجي نفسه. مثل الاستثناء أعلاه، يحدث ذلك في أغلب الأحيان للدوالّ المخصّصة التي يتمّ استدعاؤها بشكل متكرّر في جدول بيانات واحد.