توضّح هذه الصفحة الحدود والقيود المختلفة في نصوص "إعلانات Google" البرمجية التي يجب أن تكون على دراية بها. يمكن أن تتغيّر هذه الحدود في أي وقت بدون تحذير، لذا تأكَّد من أنّ نصوصك البرمجية مرنة وتحتوي على معالجة للأخطاء.
الحدود الزمنية للتنفيذ
نصوص "إعلانات Google" البرمجية
يمكن تنفيذ نصوص "إعلانات Google" البرمجية لحسابات المعلِنين لمدة 30 دقيقة كحدّ أقصى، وبعد ذلك سيتم إلغاؤها. سيتم تطبيق جميع التغييرات التي تم إجراؤها قبل إلغاء النص البرمجي.
نصوص "إدارة الإعلانات" البرمجية
يمكن عادةً تنفيذ نصوص "إدارة الإعلانات" البرمجية لمدة 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" الأساسية حصصًا يومية وحدودًا قصوى على بعض الميزات. يمكنك الاطّلاع على قائمة بهذه الحصص ورسائل الاستثناءات المصاحبة.
النصوص البرمجية المصرَّح بها
يتم استخدام OAuth2 لمنح الإذن للنصوص البرمجية. يبلغ الحدّ الأقصى لعدد النصوص البرمجية المسموح بها لكل حساب 250. بعد هذا الحد، سيتم إلغاء تفويض أحد النصوص البرمجية التي تم تفويضها سابقًا. هذا الإجراء مؤقت فقط، ويمكن إعادة تفويض النص البرمجي في المرة التالية التي يتم فتحه فيها.
إذا كنت تواجه هذا الحدّ بشكل متكرّر، ننصحك باستخدام حسابات مستخدمين متعدّدة لمنح الإذن لمجموعات مختلفة من النصوص البرمجية.
حملات الفيديو وحملات تسوّق
سيعمل محدِّد الحملات العادية (AdsApp.campaigns().get()) على فلترة
حملات الفيديو وحملات Shopping
من النتائج. استخدِم أدوات اختيار الحملات المخصّصة بدلاً من ذلك: