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

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

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

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

القيود العامة على الحصص

تنطبق الحصص التالية على Management API وCore Reporting API 3 وMCF Reporting API وMetadata API وUser Delete API و الوقت الفعلي لإعداد التقارير في الوقت الفعلي:

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

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

تُطبِّق "إحصاءات Google" الحصص على الطلبات المتعلّقة بواجهات برمجة تطبيقات الإدارة هذه:

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

تنطبق هذه الحصص على طلبات الكتابة (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):
  • 50 مجموعة بيانات لكل موقع
  • 50 عملية تحميل لكل موقع في اليوم
  • 1 غيغابايت لكل ملف تم تحميله
  • الحدود الخاصة ببيانات التكلفة:
    • 100 ميغابايت لكل تاريخ (ga:date) لكل مجموعة بيانات. على سبيل المثال، إذا استوردت 50 ميغابايت من بيانات 10-10-2014 في عملية تحميل واحدة و50 ميغابايت ليوم 10-10-2014 في عملية تحميل ثانية، فقد وصلت إلى الحد 100 ميغابايت لمجموعة البيانات 2014-10-10 لمجموعة البيانات هذه.

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

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

  • 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"، تعرض واجهة برمجة التطبيقات رمز خطأ 403 أو 429 ورسالة تفيد بأن الحساب قد تجاوز الحصة. لمزيد من المعلومات، يمكنك الاطّلاع على بنود الخدمة.

طلب حصة إضافية

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

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

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

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

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