الحدود القصوى للاستخدام

يتم التحقّق من الحصة استنادًا إلى متوسط متحرك مدته 60 ثانية، ما يسمح بزيادة الاستخدام بشكل كبير . تخضع Classroom API تلقائيًا للحدود الموضّحة في الجدول التالي:

الحدّ مقياس الحصة
الطلبات في اليوم لكل عميل ‫4,000,000 (متوسط 46 طلبًا في الثانية)
الطلبات في الدقيقة لكل عميل ‫3,000 (50 طلبًا في الثانية)
الطلبات في الدقيقة لكل مستخدم ‫1,200 (20 طلبًا في الثانية)

قد يرتفع عدد الطلبات المسموح بها في الثانية أو ينخفض استنادًا إلى عدد من العوامل التشغيلية.

إذا كنت بحاجة إلى تقديم طلبات أكثر من الحدود المفروضة على مشروعك:

  1. في البداية، تأكَّد من الردّ على الأخطاء القابلة لإعادة المحاولة (مثل الخطأ RESOURCE_EXHAUSTED الذي يتم عرضه عندما يتجاوز الطلب الحدود المسموح بها) من خلال إعادة محاولة الطلب، ويُفضَّل استخدام التراجع الأسي.
  2. إذا كنت تجري عملية الاقتراع بحثًا عن التغييرات على نقطة نهاية تتيح ذلك، ننصحك باستخدام الإشعارات الفورية بدلاً من ذلك.
  3. إذا كنت لا تزال بحاجة إلى تقديم طلبات أكثر من الحدود المخصّصة لمشروعك، اطّلِع على التعليمات أدناه بشأن طلب حدود أعلى.

لعرض حدود الاستخدام الخاصة بمشروعك أو تغييرها أو طلب زيادة حصتك، اتّبِع الخطوات التالية:

  1. إذا لم يكن لديك حساب فوترة لمشروعك، أنشئ حسابًا.
  2. انتقِل إلى صفحة واجهات برمجة التطبيقات المفعّلة في مكتبة واجهات برمجة التطبيقات في واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
  3. لعرض الإعدادات المتعلقة بالحصة وتغييرها، انقر على الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.