يتم التحقّق من الحصة استنادًا إلى متوسط متحرّك لمدة 60 ثانية، ما يسمح بالارتفاعات في الاستخدام. وفقًا للإعدادات التلقائية، تخضع Classroom API للحدود الموضحة في الجدول التالي:
| الحدّ المسموح به | معيار الحصة |
|---|---|
| طلبات البحث في اليوم لكل عميل | 4,000,000 (متوسط 46 Q في الثانية) |
| طلبات البحث في الدقيقة لكل عميل | 3,000 (50 QPS) |
| طلبات البحث في الدقيقة لكل مستخدم | 1,200 (20 QPS) |
ويمكن زيادة عدد الطلبات في الثانية المسموح به أو خفضه استنادًا إلى عدد من العوامل التشغيلية.
إذا كنت بحاجة إلى تقديم طلبات أكثر من الحدود المطبقة على مشروعك:
- عليك أولاً التأكّد من استجابتك للأخطاء التي يمكن إعادة المحاولة (مثل خطأ
RESOURCE_EXHAUSTEDالذي يظهر عندما يتجاوز الطلب الحدود القصوى المسموح بها)، وذلك من خلال إعادة محاولة تنفيذ الطلب، ويفضَّل استخدام ميزة التراجع الأسّي. - إذا كنت تُجري استطلاعًا بشأن التغييرات على نقطة نهاية تتوفّر فيها هذه الميزة، ننصحك باستخدام الإشعارات الفورية بدلاً من ذلك.
- إذا كنت لا تزال بحاجة إلى تقديم طلبات أكثر من الحدود الموضوعة لمشروعك، فانظر أدناه للحصول على إرشادات حول طلب حدود أعلى.
لعرض حدود الاستخدام لمشروعك أو تغييرها أو لطلب زيادة الحصة، يُرجى اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة لمشروعك من قبل، أنشئ حسابًا.
- انتقِل إلى صفحة Enabled APIs في مكتبة واجهة برمجة التطبيقات في وحدة تحكُّم واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
- لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، اختَر الاستخدام.