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