تتضمّن خدمات برمجة تطبيقات Google حصصًا يومية وقيودًا على بعض الميزات. في حال تجاوزت حصة أو حدًا، سيعرض البرنامج النصي استثناءً ويتوقف التنفيذ.
تتضمّن بعض الميزات حصصًا إضافية من منتج Google المرتبط بها. يُحتسب استخدام خدمة برمجة تطبيقات الخاصة بأحد المنتجات ضمن جميع احتياطيات الحصة المرتبطة. تصبح إحدى الميزات غير متاحة إذا بلغت أيًا من الحصص المرتبطة بها.
الحصص الحالية
يتم ضبط الحصص على مستويات مختلفة لمستخدمي الحسابات الاستهلاكية (مثل gmail.com) وحسابات Google Workspace. تكون الحصص لكل مستخدم ويتم إعادة ضبطها بعد 24 ساعة من الطلب الأول.
استخدِم الحصص التالية للمساعدة في اختبار النصوص البرمجية. يمكن في أي وقت وبدون إشعار مسبق إلغاء جميع الحصص أو تخفيضها أو تغييرها.
| الميزة | حسابات المستهلكين (على سبيل المثال، gmail.com) | حسابات 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 / يوم |
| إجمالي وقت التشغيل للعوامل المشغلة | 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 / يوم |
تنطبق حدود إضافية على الحسابات التجريبية. بعد التحويل من حساب فترة تجريبية مجانية إلى اشتراك مدفوع، تزيد حدود حسابك تلقائيًا، عند تحقق الأمرين التاليين:
- بعد دفع ما لا يقل عن 100 دولار أمريكي (أو ما يعادله بالعملة المحلية) لنطاقك على نحو تراكمي
- بعد مرور 60 يومًا على الأقل منذ بلوغ هذا الحد الأدنى لدفع الأرباح
القيود الحالية
استخدِم الحدود التالية للمساعدة في اختبار النصوص البرمجية. يمكن في أي وقت إلغاء جميع الحدود أو تقليلها أو تغييرها بدون إشعار.
| الميزة | حسابات المستهلكين (مثل gmail.com) | حسابات 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 / نص |
مراقبة استخدام الحصة
لمراقبة استهلاك الحصة وتنفيذ البرنامج النصي بشكل سليم، استخدِم الطريقتَين التاليتَين:
- حصة البريد الإلكتروني: استخدِم
MailApp.getRemainingDailyQuota()للاطّلاع على عدد مستلمي الرسائل الإلكترونية المتبقّين الذين يمكنك إرسال الرسائل إليهم خلال بقية اليوم. - مراقبة التنفيذ: استخدِم لوحة بيانات برمجة تطبيقات لعرض سجلّ تنفيذ النص البرمجي وحالته. تعرض صفحة عمليات التنفيذ الخاصة بي حالة كل عملية تنفيذ نص برمجي (على سبيل المثال،
CompletedأوFailedأوRunning). يمكنك تتبُّع عدد عمليات التنفيذ المتزامنة من خلال فلترة عمليات التنفيذ التي تحمل الحالةRunning. - وحدة تحكّم Google Cloud: إذا كان مشروع "برمجة تطبيقات Google" يستخدم مشروعًا عاديًا على Google Cloud، يمكنك رصد الحصص الخاصة بالخدمة واستخدام واجهة برمجة التطبيقات في وحدة تحكّم 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.يشير هذا إلى أنّ هناك عددًا كبيرًا جدًا من النصوص البرمجية التي يتم تنفيذها في الوقت نفسه، وليس بالضرورة النص البرمجي نفسه. وكما هو الحال مع الاستثناء السابق، يحدث هذا الاستثناء في أغلب الأحيان مع الدوال المخصّصة التي يتم استدعاؤها بشكل متكرّر في جدول بيانات واحد.