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