الحصص

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

حدود الحصص

تتم مشاركة حدود الحصص التلقائية التالية بواسطة جميع موارد Bid Manager API وطرقها.

• 2,000 طلب لكل مشروع في اليوم - يمكن زيادته.
• 4 طلبات في الثانية (QPS) لكل مشروع.
  • وفي وحدة تحكّم Google API، يُشار إلى هذه الحصة باسم طلبات البحث في الدقيقة لكل مستخدم، ويتم ضبطها على 240 طلب.

ملاحظة: تتم إعادة تحميل الحصص اليومية في منتصف الليل بتوقيت المحيط الهادئ.

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

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

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

الرمز	السبب	مراسلة	الإجراء المقترَح
403	dailyLimitExceeded	تم تجاوز الحد اليومي	يُرجى عدم إعادة المحاولة بدون حلّ المشكلة. تحقَّق من استخدامك من وحدة تحكّم Google API وعدِّل سير العمل لإجراء عدد أقل من الطلبات. يمكنك طلب حصة إضافية إذا كنت تعتقد أنّ استخدامك معقول.
403	userRateLimitExceeded	تم تجاوز حد معدل المستخدمين	يمكنك إبطاء معدل إرسال الطلبات باستخدام ميزة التراجع الدليلي.

ما معنى "التراجع الأُسيّ"؟

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

يؤدي استخدام ميزة "التراجع الأسي" إلى زيادة كفاءة استخدام معدل نقل البيانات، وتقليل عدد الطلبات المطلوبة للحصول على استجابة ناجحة، وزيادة سرعة معالجة الطلبات في البيئات المتزامنة.

في ما يلي الخطوات التي يجب اتّباعها لتنفيذ تراجع أسي بسيط:

1. يمكنك تقديم طلب إلى واجهة برمجة التطبيقات.
2. يتم تلقّي استجابة HTTP 503، ما يشير إلى أنّه يجب إعادة محاولة الطلب.
3. يُرجى الانتظار لمدة ثانية واحدة مع قيمة عشوائية لـ العشوائي_number_milliseconds وإعادة محاولة الطلب.
4. يتم تلقّي استجابة HTTP 503، ما يشير إلى أنّه يجب إعادة محاولة الطلب.
5. انتظِر لمدة ثانيتين مع إضافة عشوائي_number_milliseconds، وأعِد محاولة إجراء الطلب.
6. يتم تلقّي استجابة HTTP 503، ما يشير إلى أنّه يجب إعادة محاولة الطلب.
7. انتظِر لمدة 4 ثوانٍ + العشوائي_number_milliseconds، ثم أعِد محاولة إجراء الطلب.
8. يتم تلقّي استجابة HTTP 503، ما يشير إلى أنّه يجب إعادة محاولة الطلب.
9. انتظِر لمدة 8 ثوانٍ مع إضافة عشوائي_number_milliseconds، ثم أعِد محاولة إجراء الطلب.
10. يتم تلقّي استجابة HTTP 503، ما يشير إلى أنّه يجب إعادة محاولة الطلب.
11. انتظِر لمدة 16 ثانية بالإضافة إلى قيمة عشوائية قدرها 16 ثانية عشوائيًا، ثم أعِد محاولة إجراء الطلب.
12. إيقاف. الإبلاغ عن خطأ أو تسجيله

في التدفق أعلاه، alternate_number_milliseconds هو عدد عشوائي بالملي ثانية أقل من أو يساوي 1000. ويعد هذا أمرًا ضروريًا، نظرًا لأن إدخال تأخير عشوائي صغير يساعد في توزيع التحميل بشكل متساوٍ وتجنب إمكانية ختم الخادم. يجب إعادة تحديد قيمة عشوائية number_number_milliseconds بعد كل انتظار.

ملاحظة: يكون وقت الانتظار دائمًا (2 ^ n) + العشوائي_number_milliseconds، حيث يمثِّل n عددًا صحيحًا متزايدًا ويتضاعف مع تحديده في البداية على أنّه 0. تتم زيادة العدد الصحيح n بمقدار 1 لكل تكرار (كل طلب).

يتم تعيين الخوارزمية على الانتهاء عندما تكون n هي 5. ويمنع هذا الحد الأقصى للعملاء من تكرار المحاولة إلى ما لا نهاية، ويؤدي إلى تأخير إجمالي يصل إلى 32 ثانية تقريبًا قبل أن يتم تصنيف الطلب على أنه "خطأ لا يمكن إصلاحه". لا بأس في زيادة الحد الأقصى لعدد عمليات إعادة المحاولة، خاصةً إذا كان هناك تحميل طويل قيد التقدم؛ فقط تأكد من تحديد مدة تأخير إعادة المحاولة بأقل من دقيقة واحدة على سبيل المثال.

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

إذا كنت تعتقد أنّ طلبك يتطلب حصة يومية إضافية، يمكنك طلب المزيد من خلال اتّباع التعليمات أدناه.

لا تنطبق التعليمات التالية إلا على المشاريع التي واجهت خطأ dailyLimitExceeded. يتضمّن الجدول أعلاه الإجراءات المقترَحة للأخطاء الأخرى المتعلّقة بالحصص.

1. انتقِل إلى Bid Manager API في وحدة التحكم في Google API.
2. راجِع إحصاءات الاستخدام من صفحة المقاييس للتأكّد من أنّ تطبيقك يعمل على النحو المتوقّع. يُرجى الانتباه جيدًا إلى الطرق التي تم الاتصال بها ومعالجة أي استخدام غير متوقع أو زائد قبل المتابعة.
3. إذا كان الاستخدام يبدو طبيعيًا، انتقِل إلى صفحة الحصص، وانقر على رمز التعديل بجانب طلبات البحث في اليوم، ثم انقر على الرابط "تقديم طلب للحصول على حصة أعلى".

احرص على مراجعة المعلومات واتّباع التعليمات المضمَّنة في نموذج طلب الحصة قبل إرسال طلب زيادة.

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