الحدود والحصص في طلبات واجهة برمجة التطبيقات

يوضِّح هذا المستند الحدود والحصص المسموح بها لطلب واجهات برمجة التطبيقات للإدارة وواجهات برمجة التطبيقات لإعداد التقارير.

تستخدم ملايين المواقع الإلكترونية خدمة "إحصاءات Google". نضع حدودًا وحصصًا على طلبات البيانات من واجهة برمجة التطبيقات بهدف حماية النظام من تلقّي بيانات إضافية تتجاوز قدرته على التعامل مع البيانات، وضمان توزيع موارد النظام بشكل عادل. تخضع الحدود والحصص للتغيير.

يناقش هذا الفيديو أفضل الممارسات لإدارة حصص طلبات Google Analytics API.

الحدود العامة للحصة

تنطبق الحصص التالية على Management API والإصدار 3 من واجهة برمجة التطبيقات لإعداد التقارير الأساسية وMCF Reporting API وواجهة برمجة التطبيقات للبيانات الوصفية وUser Deletion API وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي:

  • 50,000 طلب لكل مشروع في اليوم، والتي يمكن زيادتها.
  • 10 طلبات في الثانية (QPS) لكل عنوان IP
    • في وحدة تحكم واجهة برمجة التطبيقات، توجد حصة مماثلة يشار إليها باسم الطلبات لكل 100 ثانية لكل مستخدم. بشكل تلقائي، يتم ضبط هذا الإعداد على 100 طلب لكل 100 ثانية لكل مستخدم، ويمكن تعديله إلى قيمة قصوى تبلغ 1,000. في المقابل، إنّ عدد الطلبات المرسَلة إلى واجهة برمجة التطبيقات يقتصر على 10 طلبات في الثانية الواحدة لكل مستخدم.
    • إذا كان تطبيقك يُجري جميع طلبات البيانات من واجهة برمجة التطبيقات من عنوان IP واحد (مثلاً بالنيابة عن المستخدمين)، يُرجى استخدام المَعلمة userIP أو quotaUser مع كل طلب للحصول على حصة الطلبات في الثانية الكاملة لكل مستخدم. راجِع ملخّص مَعلمات طلب البحث العادية للحصول على التفاصيل.

Reporting APIs

تنطبق الحصص التالية على جميع واجهات برمجة التطبيقات Reporting API، بما في ذلك الإصدار الثالث من واجهة برمجة التطبيقات لإعداد التقارير الأساسية والإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google" والإصدار الثالث من واجهة برمجة التطبيقات في الوقت الفعلي والإصدار الثالث من واجهة برمجة التطبيقات للمسار متعدد القنوات:

  • 10,000 طلب لكل مشاهدة (الملف الشخصي) يوميًا (لا يمكن زيادتها)
  • 10 طلبات متزامنة لكل مشاهدة (الملف الشخصي) (لا يمكن زيادتها)

يوفّر هذا السلوك نهجًا أكثر دقة وأمانًا من حيث الإخفاق في إدارة الحصص، بحيث لا تؤدي المكالمات المتكررة التي تستخدم واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي في "إحصاءات Google" إلى حظر جميع طلبات البيانات من واجهة برمجة تطبيقات "إحصاءات Google" الأخرى عن طريق الخطأ لبقية اليوم لملف شخصي فردي.

أخطاء طلبات واجهات برمجة التطبيقات لإعداد التقارير

إذا تعذّر إرسال طلبك إلى 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 صباحًا من اليوم التالي، ستتم إعادة تعيين حصة معدل أخطاء الخادم بالكامل لهذا المشروع والعرض.

تم تجاوز حدود الحصة.

إذا تم تجاوز حصة طلب Google Analytics API، ستعرض واجهة برمجة التطبيقات رمز الخطأ 403 أو 429 ورسالة تفيد بأن الحساب قد تجاوز الحصة المسموح بها. راجِع بنود الخدمة للاطّلاع على مزيد من المعلومات.

جارٍ طلب حصة إضافية

يمكنك طلب زيادة ما يلي فقط:

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

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

لطلب زيادة الحد الأقصى للحصة، يُرجى استخدام نموذج طلب حصة واجهة برمجة تطبيقات "إحصاءات Google". تأكَّد من مراجعة المعلومات واتّباع التعليمات الواردة في نموذج طلب الحصة قبل إرسال الطلب. بالنسبة إلى الإصدار 4 من Reporting API، يكون اسم واجهة برمجة التطبيقات في وحدة تحكّم Google API هو Google Analytics Reporting API. جميع واجهات برمجة التطبيقات الأخرى ذات الإصدار 3 (على سبيل المثال، وقد تمّ إدراج Management API الإصدار 3، وCore Reporting API الإصدار 3، والإصدار 3 من Real Time Reporting API، والإصدار 3 من User Deletion API) ضِمن واجهة برمجة تطبيقات "إحصاءات Google" في وحدة تحكّم Google API.

لمزيد من المعلومات حول إدارة الحصة وكيفية ضبط تطبيقك لاستخدام الحصة، يُرجى الاطّلاع على مراقبة واجهات برمجة التطبيقات وتحديد الاستخدام.