الحدود

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

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

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

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

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

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

حدود العناصر

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

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

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

    سيؤدي الرقم 10,000 إلى حدوث خطأ في وقت التشغيل.

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

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

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

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

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

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

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

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

حصص خدمات Google

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

النصوص البرمجية المصرَّح بها

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

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

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

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