يصف هذا المستند الحدود والحصص المطلوبة لطلب واجهات برمجة التطبيقات للإدارة وواجهات برمجة التطبيقات لإعداد التقارير.
يستخدم "إحصاءات 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 لكل مستخدم. يمكنك الاطّلاع على ملخّص معلَمات طلب البحث العادية لمعرفة التفاصيل.
Reporting APIs
تنطبق الحصص التالية على جميع واجهات برمجة التطبيقات لإعداد التقارير، بما في ذلك الإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير الأساسية، والإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google"، والإصدار 3 من واجهة برمجة التطبيقات في الوقت الفعلي، والإصدار 3 من واجهة برمجة التطبيقات للمسارات المتعددة القنوات:
- 10,000 طلب لكل مشاهدة (الملف الشخصي) في اليوم (لا يمكن زيادةها)
- 10 طلبات متزامنة لكل ملف شخصي (لا يمكن زيادتها)
أخطاء طلب واجهات برمجة التطبيقات لإعداد التقارير
إذا تعذّر تنفيذ طلبك بشأن "واجهة برمجة التطبيقات لإعداد التقارير" وظهر خطأ في الخادم، ستتلقّى
رمز الاستجابة 500 أو 503. يمكنك إعادة إرسال الطلب، ومع ذلك لا تُعِد إرسال هذا الطلب أكثر من مرة في حال تعذّر إرساله بشكل متكرّر. تسمح خدمة "إحصاءات Google"
بما يلي:
- 10 طلبات خطأ في الخادم تعذّر تنفيذها لكل مشروع لكل ملف شخصي في الساعة
- 50 طلبًا فاشلاً من الخادم يفشل في كل مشروع لكل ملف شخصي في اليوم
وإذا تجاوز عدد هذه الطلبات هذه الحصص، ستحصل على الخطأ التالي:
Quota Error: The number of recent reporting API requests failing by server error is too high. You are temporarily blocked from the reporting API for at least an hour. Please send fewer server errors in the future to avoid being blocked.
لتقليل احتمالات حدوث خطأ في خادم الطلب، يمكنك تبسيط الطلب عن طريق: تقليل النطاق الزمني، أو تقليل عدد الأبعاد في الطلب، أو تقليل عدد المقاييس في الطلب.
لا تُعِد إرسال طلب تعذّر تنفيذه بشكل مستمر. بدلاً من ذلك، نفِّذ إجراء التراجع الأسي لإعادة إرساله.
يتم فرض حصص معدل الخطأ على الخادم خلال فترات زمنية متعاقبة على كل حصة من حصة عدد الأخطاء في اليوم الواحد. بعد ساعة واحدة من تشغيل المشروع وعرض خطأ في الخادم الأول، تتم إعادة ضبط الحصة. في حال إرسال زوج من المشروع والعرض 10 أخطاء في الخادم خلال ساعة واحدة، يتم حظر زوج المشاريع والعرض من واجهة برمجة التطبيقات إلى أن تختفي أول ساعة من حدوث خطأ الخادم.
على سبيل المثال، إذا لم يرسل زوج المشاريع والعرض خطأً في الخادم خلال آخر 24 ساعة، سيستخدم هذا المشروع وطريقة العرض 0 من الحصة البالغة 50 حصة. لنفترض أن هذا المشروع والعرض يعرضان الآن خطأ في الخادم عند الساعة 6:12 صباحًا. وفي حال إرسال هذا المشروع والعرض 49 خطأ إضافي في الخادم قبل الساعة 6:12 صباحًا من اليوم التالي، سيتم حظر هذا المشروع والعرض حتى الساعة 6:12 صباحًا من اليوم التالي. في الساعة 6:12 صباحًا من اليوم التالي، ستتم إعادة ضبط حصة معدل أخطاء الخادم بالكامل لهذا المشروع والعرض.
الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google"
لا تنطبق هذه الحصص إلا على الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google" فقط:
- عدد الطلبات في اليوم لكل مشروع: 50,000
- عدد الطلبات لكل ملف شخصي في اليوم: 10,000 طلب (لا يمكن زيادتها)
- عدد الطلبات لكل 100 ثانية لكل مشروع: 2,000
- عدد الطلبات لكل 100 ثانية لكل مستخدم لكل مشروع: 100 (يمكن زيادة عدد هذه الطلبات في وحدة تحكم واجهة برمجة تطبيقات Google إلى 1000).
يمكنك عرض حصص مشروعك في وحدة تحكم واجهة برمجة تطبيقات Google.
الحصة المستندة إلى المورد
يخضع الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google" أيضًا للحصة الاختيارية المستندة إلى الموارد التي تسمح باستخدام حدود أعلى أخذ العينات لعملاء "إحصاءات 360".
تجاوز حدود الحصة
وفي حال تجاوز الحصة المطلوبة لطلب واجهة برمجة التطبيقات في "إحصاءات Google"، تعرض واجهة برمجة التطبيقات رمز خطأ 403 أو 429 ورسالة تفيد بأن الحساب قد تجاوز الحصة. لمزيد من المعلومات، يمكنك الاطّلاع على بنود الخدمة.
طلب حصة إضافية
يمكنك فقط طلب زيادة:
- عدد طلبات القراءة اليومية لكل مشروع (50,000 طلب تلقائي)
- عدد طلبات الكتابة اليومية لكل مشروع (50 طلبًا تلقائيًا)
لعرض حدود الاستخدام في مشروعك أو تغييرها، أو لطلب زيادة في حصتك، يُرجى اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة لمشروعك، عليك إنشاء حساب.
- انتقِل إلى صفحة "واجهات برمجة التطبيقات" التي تم تفعيلها لمكتبة واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة التطبيقات، واختَر واجهة برمجة تطبيقات من القائمة.
- لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، اختَر الاستخدام.
ولطلب زيادة الحد الأقصى لمقدار الحصة، يُرجى استخدام نموذج طلب حصة واجهة برمجة التطبيقات في "إحصاءات Google". يُرجى مراجعة المعلومات واتّباع التعليمات الواردة في نموذج طلب الحصة قبل إرسال الطلب. بالنسبة إلى الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير، اسم واجهة برمجة التطبيقات في وحدة تحكم Google API هو واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google". جميع واجهات برمجة التطبيقات الأخرى للإصدار 3، (مثل الإصدار 3 من Management API والإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير الأساسية والإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي والإصدار 3 من واجهة برمجة تطبيقات حذف بيانات المستخدم) ضمن واجهة برمجة التطبيقات لخدمة "إحصاءات Google" في وحدة تحكم Google API.
للحصول على مزيد من المعلومات حول إدارة الحصة وكيفية تحسين تطبيقك لاستخدام الحصة، يمكنك الاطّلاع على مراقبة واجهات برمجة التطبيقات وتحديد الاستخدام.