الحدود

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

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

نصوص "إعلانات 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 الأساسية حصصًا يومية وحدودًا قصوى على بعض الميزات. يمكنك الاطّلاع على قائمة بهذه الحصص ورسائل الاستثناءات المصاحبة.

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

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

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

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

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