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