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

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

تستخدم ملايين المواقع الإلكترونية خدمة "إحصاءات 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 مع كل طلب للحصول على حصة الطلبات في الثانية الكاملة لكل مستخدم. راجِع ملخّص مَعلمات طلب البحث العادية للحصول على التفاصيل.

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

تطبِّق "إحصاءات 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. جميع واجهات برمجة التطبيقات الأخرى ذات الإصدار 3 (على سبيل المثال، وقد تمّ إدراج Management API الإصدار 3، وCore Reporting API الإصدار 3، والإصدار 3 من Real Time Reporting API، والإصدار 3 من User Deletion API) ضِمن واجهة برمجة تطبيقات "إحصاءات Google" في وحدة تحكّم Google API.

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