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

يتم استخدام Google Analytics من قِبل ملايين المواقع. نحن نضع حدودًا وحصصًا على طلبات واجهة برمجة التطبيقات لحماية النظام من تلقي بيانات أكثر مما يمكنه التعامل معه، ولضمان التوزيع العادل لموارد النظام. تخضع الحدود والحصص للتغيير.

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

تنطبق الحصص التالية على واجهة برمجة تطبيقات حذف بيانات المستخدمين:

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

تجاوُز الحدود القصوى للحصة

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

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

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

  • عدد طلبات القراءة اليومية لكل مشروع (50,000 طلب تلقائي).
  • عدد طلبات الكتابة اليومية لكل مشروع (50 تلقائيًا).

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

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

لطلب زيادة الحد الأقصى لمبلغ الحصة، استخدِم نموذج طلب حصة واجهة برمجة التطبيقات في "إحصاءات Google". احرص على مراجعة المعلومات واتّباع التعليمات الواردة في نموذج طلب الحصّة قبل إرسال الطلب.

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