الحدود القصوى المسموح بها

توضّح هذه الصفحة الحدود والقيود المختلفة في نصوص "إعلانات 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()) على فلترة حملات الفيديو والتسوّق من النتائج. استخدِم أدوات اختيار الحملات المخصّصة بدلاً من ذلك: