تتضمّن خدمات "برمجة التطبيقات" حصصًا يومية وقيودًا على بعض الميزات. وإذا تجاوزت الحصّة أو القيد، سيفرض النص البرمجي استثناءً وإيقاف التنفيذ.
ملاحظة مهمّة: تحتوي بعض الميزات على حصص إضافية من منتج Google المرتبطة بها. يُحتسَب استخدام خدمة "برمجة تطبيقات Google" للمنتج ضمن جميع حصص الحصص المرتبطة. تصبح الميزة غير متاحة إذا وصلت إلى أي من الحصص المرتبطة.
الحصص الحالية
يتم تحديد الحصص على مستويات مختلفة لمستخدمي حسابات المستهلكين (مثل gmail.com) أو الإصدار المجاني من G Suite (المتوقف نهائيًا) وحسابات Google Workspace. تكون الحصص لكل مستخدم وتتم إعادة تعيينها بعد 24 ساعة من الطلب الأول.
استخدِم الحصص أدناه لمساعدتك في اختبار نصوصك البرمجية. تخضع جميع الحصص للحذف أو التخفيض أو التغيير في أي وقت، وبدون إشعار.
| إبراز | المستهلك (مثل gmail.com) و الإصدار المجاني من G Suite (القديم) |
حسابات Google Workspace |
|---|---|---|
| أحداث التقويم التي يتم إنشاؤها | 5000 / يوم | 10000 / يوم |
| جهات الاتصال التي يتم إنشاؤها | 1000 / اليوم | 2000 / يوم |
| تمّ إنشاء المستندات | 250 / يوم | 1500 / يوم |
| تم تحويل الملفات | 2000 / يوم | 4000 / اليوم |
| مستلمو البريد الإلكتروني لكل يوم | 100* / في اليوم | 1500* / في اليوم |
| مستلمو البريد الإلكتروني لكل يوم داخل النطاق | 100* / في اليوم | 2000 / يوم |
| قراءة/كتابة البريد الإلكتروني (باستثناء الإرسال) | 20000 / يوم | 50000 / يوم |
| قراءة المجموعات | 2000 / يوم | 10000 / يوم |
| اتصال JDBC | 10000 / يوم | 50000 / يوم |
| اتصالات JDBC التي تؤدي إلى الإخفاق | 100 / يوم | 500 / يوم |
| العروض التقديمية التي يتم إنشاؤها | 250 / يوم | 1500 / يوم |
| قراءة/كتابة الخصائص | 50000 / يوم | 500000 / يوم |
| تم إنشاء الشرائح. | 250 / يوم | 1500 / يوم |
| جداول البيانات التي يتم إنشاؤها | 250 / يوم | 3200 / اليوم |
| إجمالي وقت التشغيل للعوامل المشغلة | 90 دقيقة / اليوم | 6 ساعات / يوم |
| استدعاءات إحضار بيانات من عنوان URL | 20000 / يوم | 100000 / يوم |
| عرض الخريطة الثابتة | 1000 / اليوم | 10000 / يوم |
| طلب البحث عن الاتجاهات في خريطة Google | 1000 / اليوم | 10000 / يوم |
| مكالمات الترميز الجغرافي لتطبيق "خرائط Google" | 1000 / اليوم | 10000 / يوم |
| ترجمة المكالمات | 5000 / يوم | 20000 / يوم |
| طلب بحث عن نماذج الارتفاع في خريطة Google | 1000 / اليوم | 10000 / يوم |
| مشاريع "برمجة التطبيقات" | 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 | 50 ميغابايت / المكالمة | 50 ميغابايت / المكالمة |
| عناوين جلب عناوين URL | 100 / مكالمة | 100 / مكالمة |
| حجم عنوان جلب عنوان URL | 8 كيلوبايت / اتصال | 8 كيلوبايت / اتصال |
| حجم المشاركة للحصول على عنوان URL | 50 ميغابايت / المكالمة | 50 ميغابايت / المكالمة |
| طول عنوان URL لجلب عنوان URL | 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.يشير هذا إلى أنّ لديك عددًا كبيرًا جدًا من النصوص البرمجية التي يتم تنفيذها في وقت واحد، وليس بالضرورة النص البرمجي نفسه. على غرار الاستثناء أعلاه، يحدث هذا غالبًا في الدوال المخصصة التي يتم استدعاءها بشكل متكرر في جدول بيانات واحد.