الحدود

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

الحدود الزمنية لتنفيذ الإجراءات

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

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

يمكن تنفيذ النصوص البرمجية في "مدير إعلانات Google" عادةً لمدة 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 نصّ برمجي مفوَّض كحدّ أقصى. وبعد هذا الحدّ، سيتمّ إلغاء تفويض أحد ال scripts المعتمَدَين سابقًا. وهذا الإجراء مؤقت فقط، ويمكن إعادة تفويض النص البرمجي في المرة التالية التي يتم فيها فتحه.

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

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

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