يوضِّح هذا المستند الحدود والحصص المسموح بها لطلب "واجهات برمجة التطبيقات للإدارة" و"واجهات برمجة التطبيقات لإعداد التقارير".
يستخدم الملايين من المواقع الإلكترونية خدمة "إحصاءات Google". ونحن نضع حدودًا وحصصًا لطلبات البيانات من واجهة برمجة التطبيقات لحماية النظام من تلقّي بيانات أكثر من التي يمكنه التعامل معها، ولضمان التوزيع العادل لموارد النظام. تخضع هذه الحدود والحصص للتغيير.
يناقش هذا الفيديو أفضل الممارسات لإدارة حصص طلبات Google Analytics API.
حدود الحصص العامة
تنطبق الحصص التالية على Management API والإصدار 3 من واجهة برمجة التطبيقات الأساسية لإعداد التقارير وMCF Reporting API وواجهة برمجة تطبيقات البيانات الوصفية وواجهة برمجة تطبيقات حذف المستخدم وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي:
- 50,000 طلب لكل مشروع في اليوم، والتي يمكن زيادتها
- 10 طلبات في الثانية (QPS) لكل عنوان IP
- في وحدة تحكُّم واجهة برمجة التطبيقات، هناك حصّة بيانات مماثلة يُشار إليها باسم الطلبات لكل 100 ثانية لكل مستخدم. يتم ضبط القيمة تلقائيًا على 100 طلب لكل 100 ثانية لكل مستخدم، ويمكن تعديلها إلى 1,000 طلب كحدٍّ أقصى. إنّ عدد الطلبات الموجّهة إلى واجهة برمجة التطبيقات يقتصر على 10 طلبات في الثانية كحدّ أقصى لكل مستخدم.
- إذا كان تطبيقك يُجري جميع طلبات البيانات من واجهة برمجة التطبيقات من عنوان IP واحد (أي بالنيابة عن المستخدمين)، عليك استخدام المَعلمة
userIPأوquotaUserمع كل طلب للحصول على الحصة الكاملة لعدد الطلبات في الثانية لكل مستخدم. اطّلِع على ملخّص مَعلمات طلب البحث العادية لمعرفة التفاصيل.
Reporting APIs
تنطبق الحصص التالية على جميع واجهات Reporting API، بما في ذلك الإصدار 3 من واجهة برمجة التطبيقات الأساسية لإعداد التقارير، والإصدار 4 من "إحصاءات Google"، والإصدار الثالث من واجهة برمجة التطبيقات في الوقت الفعلي، والإصدار الثالث من واجهة برمجة التطبيقات للمسار المتعدد القنوات:
- 10,000 طلب لكل مشاهدة (ملف شخصي) في اليوم (لا يمكن زيادتها)
- 10 طلبات متزامنة لكل ملف شخصي) (لا يمكن زيادتها)
أخطاء طلبات واجهات برمجة التطبيقات لإعداد التقارير
إذا تعذّر إرسال طلبك إلى Reporting API وظهر خطأ في الخادم، ستحصل على رمز الاستجابة 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 من Analytics Reporting API
تنطبق هذه الحصص على الإصدار 4 من Analytics Reporting API فقط:
- عدد الطلبات يوميًا لكل مشروع: 50,000
- عدد الطلبات لكل مشاهدة (الملف الشخصي) في اليوم: 10,000 (لا يمكن زيادته)
- عدد الطلبات لكل 100 ثانية لكل مشروع: 2,000
- عدد الطلبات لكل 100 ثانية لكل مستخدم لكل مشروع: 100 (يمكن زيادته في وحدة التحكم في واجهة Google API إلى 1,000).
يمكنك عرض حصص مشروعك في وحدة التحكم في واجهة Google API.
الحصة المستندة إلى المورد
يخضع الإصدار 4 من Analytics Reporting API أيضًا إلى الحصص المستندة إلى الموارد الاختيارية التي تسمح باستخدام حدود أعلى لأخذ العيّنات لعملاء "إحصاءات Google 360".
تجاوز حدود الحصة
فإذا تم تجاوز حصة طلب Google Analytics API، ستعرض واجهة برمجة التطبيقات رمز الخطأ 403 أو 429 ورسالة تفيد بأنّ الحساب تجاوز الحصة. راجِع بنود الخدمة للاطّلاع على مزيد من المعلومات.
جارٍ طلب حصة إضافية
يمكنك طلب زيادة ما يلي فقط:
- عدد طلبات القراءة اليومية لكل مشروع (الإعداد التلقائي 50,000)
- عدد طلبات الكتابة اليومية لكل مشروع (الإعداد التلقائي 50)
لعرض حدود الاستخدام أو تغييرها لمشروعك، أو لطلب زيادة في حصتك، عليك اتّباع الخطوات التالية:
- إذا لم يكن لديك حساب فوترة لمشروعك من قبل، عليك إنشاء حساب.
- انتقِل إلى صفحة "واجهات برمجة التطبيقات المفعَّلة" في مكتبة واجهة برمجة التطبيقات في وحدة تحكُّم واجهة برمجة التطبيقات، واختَر واجهة برمجة التطبيقات من القائمة.
- لعرض الإعدادات المتعلقة بالحصص وتغييرها، اختَر الحصص. لعرض إحصاءات الاستخدام، انقر على الاستخدام.
لطلب زيادة الحد الأقصى لمبلغ الحصة، يُرجى استخدام نموذج طلب حصة واجهة برمجة تطبيقات "إحصاءات Google". تأكَّد من مراجعة المعلومات واتّباع التعليمات الواردة في نموذج طلب الحصة قبل إرسال الطلب. بالنسبة إلى الإصدار 4 من Reporting API، يكون اسم واجهة برمجة التطبيقات في وحدة تحكُّم Google API هو Google Analytics Reporting API. جميع واجهات برمجة التطبيقات الأخرى المستنِدة إلى إصدار Manifest v3 (مثل الإصدار الثالث من Management API، والإصدار 3 من Core Reporting API، والإصدار الثالث من واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي، والإصدار 3 من واجهة برمجة تطبيقات "حذف المستخدم") ضِمن واجهة برمجة تطبيقات "إحصاءات Google" في وحدة تحكُّم Google API.
للحصول على مزيد من المعلومات حول إدارة الحصص وكيفية تحسين تطبيقك لاستخدام الحصص، يُرجى الاطّلاع على مراقبة واجهات برمجة التطبيقات وتحديد الاستخدام.