تحمي الحصص البنية الأساسية لشركة Google من العمليات الآلية التي تستخدم واجهة برمجة تطبيقات "مدير الحملة 360" بطريقة غير ملائمة. وتضمن أنّ إجراءات مطوّر البرامج لا يمكن أن تؤثر سلبًا في المنتدى الأكبر.
حدود الحصة
تتم مشاركة حدود الحصة التلقائية التالية مع جميع موارد واجهة برمجة التطبيقات ومدير الحملة 360.
- 50,000 طلب لكل مشروع في اليوم - يمكن زيادتها.
- طلب بحث واحد في الثانية (QPS) لكل مشروع.
- في وحدة تحكّم Google API، يُشار إلى هذه الحصة باسم طلبات البحث في الدقيقة لكل مستخدم، ويتم ضبطها على 60 طلبًا تلقائيًا. ويمكن زيادة هذا الحدّ حسب الحاجة، فتصل إلى 600 كحدّ أقصى (10 كيلوبت في الثانية).
تفرض أداة إنشاء التقارير حدودًا إضافية للحصة تختلف حسب الحساب. للاطّلاع على مزيد من المعلومات، يُرجى الرجوع إلى مقالة مركز المساعدة هذه والجدول أدناه.
تجاوز حدود الحصة
في حال تعذُّر تنفيذ طلبك بسبب تجاوز الحدّ الأقصى لحصة الطلبات، ستعرض واجهة برمجة التطبيقات رمز حالة HTTP وسبب الخطأ. بالإضافة إلى ذلك، يحتوي نص الاستجابة على وصف تفصيلي لسبب حدوث الخطأ. يُرجى الاطّلاع على دليل رسائل الخطأ للاطّلاع على مثال عن استجابة خطأ.
تعرض القائمة التالية الأخطاء المحتملة والإجراءات المقترحة لحالات تعذُّر الطلبات الناتجة عن تجاوز حدود الحصة.
| الرمز | السبب | الرسالة | الإجراء المقترَح |
|---|---|---|---|
| 403 | تم تجاوز الحد اليومي | تم تجاوز الحد اليومي | يُرجى عدم إعادة المحاولة بدون حل المشكلة. افحص استخدامك من وحدة تحكم Google API وعدِّل سير العمل لتلبية عدد أقل من الطلبات. ويمكنك طلب حصة إضافية إذا كنت تعتقد أنّ استخدامك معقول. |
| 403 | تم تجاوز الحصة المخصصة | تجاوز هذا الحساب حصة التقارير التي تبلغ x تقرير في اليوم. | يُرجى عدم محاولة تشغيل أي تقارير أخرى لهذا الحساب في هذا اليوم. يُرجى التواصل مع مدير حسابك للحصول على مساعدة. |
| 403 | تم تجاوز الحصة المخصصة | لقد تجاوز هذا الملف الشخصي للمستخدم الحصة البالغة x تقارير في اليوم. | يُرجى عدم محاولة تشغيل أي تقارير أخرى لهذا الملف الشخصي للمستخدم في هذا اليوم. يمكنك التبديل إلى ملف شخصي مختلف للمستخدم أو التواصل مع مدير حسابك للحصول على مساعدة. |
| 403 | تم تجاوز الحصة المخصصة | تجاوز هذا الحساب حصة التقارير التي تبلغ x تقريرًا مجدوَلاً نشطًا. | أوقِف التقارير المجدوَلة التي لا تحتاج إليها قبل إعادة محاولة هذا الطلب. |
| 403 | تم تجاوز الحصة المخصصة | لقد تجاوز الملف الشخصي للمستخدم الذي يملك هذا التقرير حصة التقارير التي تبلغ x تقارير مجدولة نشطة. | اطلب من مالك هذا التقرير إيقاف التقارير المجدوَلة التي لا يحتاج إليها قبل إعادة محاولة هذا الطلب. |
| 403 | تم تجاوز الحصة المخصصة | لقد تجاوز هذا الملف الشخصي للمستخدم الحصة البالغة x تقارير مجدولة نشطة. | أوقِف التقارير المجدوَلة التي لا تحتاج إليها قبل إعادة محاولة هذا الطلب. |
| 403 | تم تجاوز الحصة المخصصة | يتعذر إكمال هذا الإجراء بسبب تجاوز إحدى حصصك. يُرجى التواصل مع مدير حسابك للحصول على مساعدة. | يُرجى التواصل مع مدير حسابك للحصول على مساعدة. |
| 403 | تم تجاوز حد المستخدم | تم تجاوز الحد الأقصى لمعدل المستخدمين. | يمكنك زيادة الحدّ الأقصى المسموح به لكل مستخدم في وحدة تحكّم Google API أو إبطاء معدّل إرسال الطلبات باستخدام معدل التراجع الأسي. لا يُنصَح بتقديم طلبات كتابة متزامنة أو استخدام حد معدل أعلى من 10 كيلوبت في الثانية باستخدام واجهة برمجة التطبيقات هذه. |
جارٍ طلب حصة يومية إضافية
إذا كنت تعتقد أنّ طلبك يتطلب حصة يومية إضافية، يمكنك طلب المزيد باتّباع التعليمات الواردة أدناه.
لا تنطبق التعليمات التالية إلا على المشاريع التي واجهت خطأ dailyLimitExceeded. تتم الإشارة إلى الإجراءات المقترحة لأخطاء الحصة الأخرى
في الجدول أعلاه.
- انتقِل إلى واجهة برمجة تطبيقات "مدير الحملة 360" في وحدة تحكّم Google API.
- راجِع إحصاءات الاستخدام من صفحة المقاييس للتأكّد من عمل تطبيقك على النحو المتوقّع. يجب الانتباه بعناية إلى الطرق التي تم طلبها ومعالجة أي استخدام غير متوقّع أو زائد قبل المتابعة.
- إذا كان الاستخدام يبدو طبيعيًا، انتقل إلى صفحة الحصص، وانقر على رمز التعديل بجانب طلبات البحث في اليوم وانقر على الرابط إلى "طلب الحصول على حصة أكبر".
تأكَّد من مراجعة المعلومات واتّبِع التعليمات الواردة في نموذج طلب عرض الأسعار التقديري قبل إرسال طلب زيادة.