الحدود القصوى للاستخدام

تحمي حدود الاستخدام بنية Google الأساسية من العمليات الآلية التي تستخدم "مساحة العرض والفيديو 360 API " بطريقة غير ملائمة. فهم يضمنون ألا تؤثر إجراءات أحد مطوري البرامج سلبًا على المجتمع الأكبر.

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

تستخدِم واجهة برمجة التطبيقات "مساحة العرض والفيديو 360" نوعَين من الحدود:

  • إجمالي الحدود القصوى للحصة، التي يتم احتسابها ضمن جميع الطلبات ذات الصلة.
  • حدود حصص الكتابة، التي يتم احتسابها وفقًا لجميع الطلبات ذات الصلة التي يتم تقديمها لطرق الكتابة. ويتم تعريف طرق الكتابة على أنّها طرق، مثل create أو patch أو delete أو bulkEdit، لتعديل الموارد. لاحظ أن بعض الطرق تستهلك حصة كتابة أكثر من الأخرى.

إذا تجاوز مشروعك أيًّا من هذه الحدود، قد يحدث التقييد.

حد الحصة على مستوى المشروع

تتم مشاركة حدود الحصص التلقائية التالية بين جميع موارد واجهة برمجة تطبيقات "مساحة العرض والفيديو 360" وطرقها:

  • إجمالي الطلبات في الدقيقة لكل مشروع: 1500
  • كتابة الطلبات في الدقيقة لكلّ مشروع: 700

حدود حصة الطلبات الخاصة بالمعلن

إنّ الطرق التي تحدّد الرقم التعريفي للمعلِن في عنوان URL للطلب تُحتسب ضمن حدود الحصص الإضافية "لكل معلن لكل مشروع".

سيتم احتساب جميع الطلبات التي تحتوي على رقم تعريفي للمعلِن محدّد في مسار عنوان URL الخاص به، مثل تلك المتعلقة بخدمات advertisers.lineItems أو advertisers.creatives أو advertisers.channels، من حدود الحصة التالية:

  • إجمالي الطلبات في الدقيقة لكل معلِن في كل مشروع: 300
  • طلبات الكتابة في الدقيقة لكل معلِن في كل مشروع: 150

طرق الكتابة المكثفة

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

عند احتساب استهلاك حصة طلبات الكتابة، يتم احتساب الطلبات المقدَّمة إلى طُرق مكثفة للكتابة كـ 5 طلبات بحث. على سبيل المثال، عند إدخال 100 طلب كتابة عادي و21 طلبًا مكثفًا، لا يتم تحديد أحد المعلِنين (لا يتم تحديد أي معلن) في غضون دقيقة، سيتم احتساب 205 طلب كتابة (100 + (21 * 5) = 205) وسيتجاوز ذلك الحدّ الأقصى لحصة الطلبات العامة الحالية التي تبلغ 200 طلب كتابة في الدقيقة.

تعتبر الطرق التالية كثيفة الكتابة:

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

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

تعرض القائمة التالية الأخطاء المحتملة والإجراءات المقترَحة بشأن حالات تعذُّر الطلبات الناتجة عن تجاوز حدود طلبات البيانات من واجهة برمجة التطبيقات.

الرمز متوسط عائد النقرة الرسالة الإجراء المقترَح
429 RESOURCE_EXHAUSTED استنفد المورد (على سبيل المثال، تحقق من الحصة). فحص طريقة استخدامك من وحدة تحكم Google API وتعديل سير عملك لتحقيق مقارنة أفضل للطلبات المقدمة من معلِنين مختلفين أو إبطاء المعدّل الذي ترسل به الطلبات بشكل عام.

لا يمكن طلب الزيادات في حدود حصة واجهة برمجة التطبيقات في "مساحة العرض والفيديو 360".