يصف هذا المستند الحدود والحصص المطلوبة لطلب واجهات برمجة التطبيقات للإدارة وواجهات برمجة التطبيقات لإعداد التقارير.
يستخدم "إحصاءات Google" ملايين المواقع الإلكترونية. نضع حدودًا وحصصًا على طلبات البيانات من واجهة برمجة التطبيقات لحماية النظام من تلقي بيانات أكثر مما يمكنه التعامل معها، وضمان توزيع عادل لموارد النظام. تخضع الحدود والحصص للتغيير.
يناقش هذا الفيديو أفضل الممارسات لإدارة حصص الطلبات في "إحصاءات Google".
القيود العامة على الحصص
تنطبق الحصص التالية على Management API وCore Reporting API 3 وMCF Reporting API وMetadata API وUser Delete API و الوقت الفعلي لإعداد التقارير في الوقت الفعلي:
- 50,000 طلب لكل مشروع في اليوم، ما يمكن زيادة.
- 10 طلبات في الثانية (QPS) لكل عنوان IP.
- في وحدة تحكم واجهة برمجة التطبيقات، هناك اقتباس مشابه يُشار إليه باسم الطلبات لكل 100 ثانية لكل مستخدم. ويتم ضبط الإعدادات تلقائيًا على 100 طلب لكل 100 ثانية لكل مستخدم، ويمكن ضبطها على 1,000 قيمة كحد أقصى. ولكن يقتصر عدد الطلبات المُرسَلة إلى واجهة برمجة التطبيقات على 10 طلبات في الثانية كحد أقصى لكل مستخدم.
- إذا كان تطبيقك يرسل جميع طلبات البيانات من واجهة برمجة التطبيقات من عنوان IP واحد
(أي بالنيابة عن المستخدمين)، يمكنك استخدام المعلَمة
userIPأوquotaUserمع كل طلب للحصول على حصة كاملة في QPS لكل مستخدم. يمكنك الاطّلاع على ملخّص معلَمات طلب البحث العادية لمعرفة التفاصيل.
تجاوز حدود الحصة
وفي حال تجاوز الحصة المطلوبة لطلب واجهة برمجة التطبيقات في "إحصاءات Google"، تعرض واجهة برمجة التطبيقات رمز خطأ 403 أو 429 ورسالة تفيد بأن الحساب قد تجاوز الحصة. لمزيد من المعلومات، يمكنك الاطّلاع على بنود الخدمة.
طلب حصة إضافية
يمكنك فقط طلب زيادة:
- عدد طلبات القراءة اليومية لكل مشروع (50,000 طلب تلقائي)
- عدد طلبات الكتابة اليومية لكل مشروع (50 طلبًا تلقائيًا)
لعرض حدود الاستخدام في مشروعك أو تغييرها، أو لطلب زيادة في حصتك، يُرجى اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة لمشروعك، عليك إنشاء حساب.
- انتقِل إلى صفحة "واجهات برمجة التطبيقات" التي تم تفعيلها لمكتبة واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
- لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، اختَر الاستخدام.
ولطلب زيادة الحد الأقصى لمقدار الحصة، يُرجى استخدام نموذج طلب حصة واجهة برمجة التطبيقات في "إحصاءات Google". يُرجى مراجعة المعلومات واتّباع التعليمات الواردة في نموذج طلب الحصة قبل إرسال الطلب. بالنسبة إلى الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير، اسم واجهة برمجة التطبيقات في وحدة تحكم Google API هو واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". جميع واجهات برمجة التطبيقات الأخرى للإصدار 3، (مثل الإصدار 3 من Management API والإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير الأساسية والإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي والإصدار 3 من واجهة برمجة تطبيقات حذف بيانات المستخدم) ضمن واجهة برمجة التطبيقات لخدمة "إحصاءات Google" في وحدة تحكم Google API.
للحصول على مزيد من المعلومات حول إدارة الحصة وكيفية تحسين تطبيقك لاستخدام الحصة، يمكنك الاطّلاع على مراقبة واجهات برمجة التطبيقات وتحديد الاستخدام.