تفرض خدمات 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.يشير ذلك إلى أنّ لديك عددًا كبيرًا جدًا من النصوص البرمجية التي يتم تنفيذها في آنٍ واحد، ولكن ليس بالضرورة النص البرمجي نفسه. مثل الاستثناء أعلاه، يحدث ذلك في أغلب الأحيان للدوالّ المخصّصة التي يتمّ استدعاؤها بشكل متكرّر في جدول بيانات واحد.