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

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

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

تستخدِم Display & Video 360 API نوعَين من الحدود:

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

إذا تجاوز مشروعك أيًا من هذه الحدود، قد يتم التضييق على سرعة.

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

تتم مشاركة حدود الحصة التلقائية التالية من قِبل جميع موارد واجهة برمجة التطبيقات وطرق "مساحة العرض والفيديو 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 Console و عدِّل سير العمل لتتم بدرجةٍ أفضل مزامنة الطلبات المقدَّمة ضمن حساب معلِنين مختلفين أو بشكلٍ عام، يمكنك تقليل معدّل إرسال الطلبات.

لا يمكن طلب زيادة حدود حصة واجهة برمجة التطبيقات Display & Video 360 API.