الحدود

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

الحدود الزمنية للتنفيذ

نصوص "إعلانات Google" البرمجية

يمكن أن يتم تنفيذ نصوص "إعلانات Google" البرمجية لحسابات المعلِنين لمدة 30 دقيقة بحدّ أقصى، وبعد ذلك سيتم إلغاؤها. وسيتم تطبيق جميع التغييرات التي تم إجراؤها قبل إلغاء النص البرمجي.

نصوص "مدير الإعلانات" البرمجية

يمكن عادةً تنفيذ نصوص "مدير الإعلانات" البرمجية لمدة 30 دقيقة بحدّ أقصى، بعد ذلك سيتم إلغاؤها. ومع ذلك، إذا كان نص "مدير الإعلانات" البرمجي يستخدم طريقة executeInParallel لمعالجة الحسابات بالتوازي ويحدّد طريقة رد الاتصال، يمكن تنفيذه لمدة تصل إلى 60 دقيقة بحدّ أقصى قبل إلغائه. يوضّح الشكل التالي ذلك، حيث إنّ processAccount هي الدالة المتوازية، وallFinished هي طريقة رد الاتصال عند استدعاء executeInParallel.

وسيتم تطبيق جميع التغييرات التي تم إجراؤها قبل إلغاء النص البرمجي.

حدود الكيانات

نصوص حسابات "إعلانات Google" البرمجية

  • سيتم تلقائيًا عرض 50,000 نتيجة بحدّ أقصى من المكرِّر الواحد. يمكنك تعديل ذلك من خلال استدعاء withLimit() على أداة الاختيار.

  • يمكن أن تعالج أداة الاختيار الواحدة 10,000 رقم تعريف بحدّ أقصى في selector.withIds(). إذا تم تحديد 10,000 رقم تعريف أو أكثر، سيؤدي selector.get() إلى ظهور خطأ في وقت التشغيل. وبالمثل، سيؤدي تحديد شرط Id IN [LIST] مع قائمة تضم أكثر من 10,000 رقم تعريف إلى ظهور خطأ في وقت التشغيل.

  • سيتم اقتطاع ناتج التسجيل عند 100 كيلوبايت. وسيتم تسجيل تحذير إذا حدث ذلك.

نصوص الحسابات الإدارية البرمجية

  • يحصل كل حساب تتم معالجته من خلال نص "مدير الإعلانات" البرمجي على حصته الخاصة كما هو موضّح في القسم السابق.

  • عند استخدام طريقة executeInParallel، يمكن أن يعالج النص البرمجي ما يصل إلى 50 حسابًا.

  • يمكن أن تعرض طريقة processAccount من executeInParallel ما يصل إلى 10 ميغابايت من البيانات.

حدود التحميلات المجمّعة

  • يقتصر ملف التحميل على 50 ميغابايت ومليون صف، وسيتم رفضه عند إرساله إذا تجاوز هذه الحدود.

  • تنتهي مهلة مهمة التحميل بعد ساعتين، وستتوقف المهمة عن معالجة أي بيانات متبقية من الملف الذي تم تحميله.

حصص خدمات Google

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

النصوص البرمجية المفوَّضة

يتم استخدام OAuth2 لتفويض النصوص البرمجية. يبلغ الحد الأقصى للنصوص البرمجية المفوَّضة 250 نصًا لكل حساب. بعد تجاوز هذا الحد، سيتم إلغاء تفويض أحد النصوص البرمجية التي تم تفويضها سابقًا. هذا الإجراء مؤقت فقط، ويمكن إعادة تفويض النص البرمجي في المرة التالية التي يتم فيها فتحه.

إذا كنت تواجه هذا الحد بشكل متكرر، ننصحك باستخدام حسابات مستخدمين متعددة لتفويض مجموعات مختلفة من النصوص البرمجية.

"حملات الفيديو" و"حملات التسوّق"

ستؤدي أداة اختيار الحملة العادية (AdsApp.campaigns().get()) إلى فلترة "حملات الفيديو" و "حملات التسوّق" من النتائج. استخدِم بدلاً من ذلك أدوات اختيار الحملات المخصّصة: