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