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

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

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

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

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

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

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

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