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

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

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

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

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

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

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

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