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