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

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

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

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

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

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

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

واجهات برمجة تطبيقات الإدارة

تطبِّق "إحصاءات Google" حصصًا على الطلبات المقدَّمة إلى واجهات Management API التالية:

كتابة واجهات برمجة التطبيقات

تنطبق هذه الحصص على طلبات الكتابة (insert وupdate وpatch وdelete):

  • 50 طلبًا كتابة لكل مشروع في اليوم، والتي يمكن زيادتها
  • 1.5 طلب في الثانية (QPS) لكل رقم تعريف حساب

كتابة أخطاء في الطلبات

إذا تعذّر طلب الكتابة وحصلت على رمز الاستجابة 500 أو 503، يمكنك إعادة إرساله. تسمح "إحصاءات Google" بما يلي:

  • 50 طلب كتابة فاشل في الساعة

إذا حاولت إرسال أكثر من 50 طلبًا فاشلًا للكتابة في الساعة، سيظهر لك الخطأ التالي:

Quota Error: The number of recent failed writes is too high.

بدلاً من إعادة إرسال طلب كتابة تعذّر بشكل مستمر، يمكنك تنفيذ خوارزمية التراجع الأسي لإعادة إرساله.

واجهة برمجة التطبيقات لاستيراد البيانات

هذه الحصص خاصة بمورد Uploads:

  • حدود تخزين استيراد البيانات الموسّعة مدى الحياة (لا ينطبق على بيانات النتائج المرسلة من واجهات برمجة تطبيقات التجميع وحزم تطوير البرامج (SDK)):
    • حدود "إحصاءات 360" في وضع استيراد وقت المعالجة:
      • 1 تيرابايت لكل موقع
      • 20 غيغابايت لكل مجموعة بيانات
    • حدود "إحصاءات 360" في وضع استيراد وقت طلب البحث:
      • 1 غيغابايت لكل موقع
      • 1 غيغابايت لكل مجموعة بيانات
    • الحدود العادية:
      • 10 غيغابايت لكل موقع
      • 10 غيغابايت لكل مجموعة بيانات
  • 50 مجموعة بيانات لكل موقع
  • 50 عملية تحميل لكل موقع في اليوم
  • 1 غيغابايت لكل ملف يتم تحميله
  • الحدود الخاصة ببيانات التكلفة:
    • 100 ميغابايت لكل تاريخ (ga:date) لكل مجموعة بيانات. على سبيل المثال، إذا استوردت 50 ميغابايت من البيانات لتاريخ 2014-10-10 في عملية تحميل واحدة و50 ميغابايت للبيانات في 10-10-2014 في عملية تحميل ثانية، فقد بلغت الحد الأقصى البالغ 100 ميغابايت ليوم 10-10-2014 لمجموعة البيانات هذه.

واجهة برمجة تطبيقات التجارب

تنطبق هذه الحصة على التجارب فقط:

  • 12 تجربة لكل ملف شخصي)

تُحتسب التجارب التي تتضمّن أحد statuses التالية ضمن هذه الحصة:

  • DRAFT
  • READY_TO_RUN
  • RUNNING

لا يتم احتساب التجارب المنتهية (الحالة = ENDED) لأكثر من يوم واحد ضمن هذه الحصة.

واجهة برمجة التطبيقات للتقارير غير المستندة إلى عينات

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

  • يتم احتساب طلبات البيانات من واجهة برمجة التطبيقات لإنشاء تقارير غير مستندة إلى عيّنات من الحصة العامة لطلبات الكتابة.
  • تستخدم واجهة برمجة التطبيقات نظام الرمز المميز لكل موقع في اليوم الذي تستخدمه واجهة الويب لإنشاء تقارير غير مستندة إلى عينات.
  • الحد الأقصى المسموح به لعدد التقارير غير المستندة إلى عينات هو 3500. عند الوصول إلى هذا الحدّ، تتم محاولة إنشاء المزيد من التقارير غير المستندة إلى عيّنات باستخدام نتائج واجهة برمجة التطبيقات في الخطأ التالي: 
    Error creating this entity. You have reached the maximum allowed entities of this type.

واجهة برمجة تطبيقات أذونات المستخدم

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

  • يمكن أن يمتلك المستخدم 100 حساب على الأكثر في "إحصاءات Google". تؤدي إضافة مستخدم لديه 100 حساب من حسابات "إحصاءات Google" إلى حساب جديد إلى حدوث خطأ.

تنطبق الحصص التالية على طلبات الكتابة المجمّعة (delete وinsert وupdate) على أذونات المستخدمين:

  • 300 طلب لأذونات المستخدمين لكل طلب مجمّع
  • يتم احتساب 30 طلبًا مجمّعًا لأذونات المستخدمين باعتبارها طلب كتابة واحد.

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

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

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

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

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

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

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

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