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