محدودیت ها

این صفحه محدودیت‌ها و قیود مختلفی را در اسکریپت‌های گوگل ادز شرح می‌دهد که باید از آنها آگاه باشید. این محدودیت‌ها می‌توانند در هر زمانی و بدون هشدار تغییر کنند، بنابراین مطمئن شوید که اسکریپت‌های شما انعطاف‌پذیر بوده و شامل مدیریت خطا هستند.

محدودیت‌های زمانی اجرا

اسکریپت‌های تبلیغات گوگل

اسکریپت‌های گوگل ادز برای حساب‌های تبلیغ‌کننده می‌توانند حداکثر ۳۰ دقیقه اجرا شوند و پس از آن لغو می‌شوند. تمام تغییراتی که قبل از لغو اسکریپت ایجاد شده‌اند، اعمال خواهند شد.

اسکریپت‌های مدیریت تبلیغات

اسکریپت‌های Ads Manager معمولاً می‌توانند حداکثر به مدت ۳۰ دقیقه اجرا شوند و پس از آن لغو می‌شوند. با این حال، اگر یک اسکریپت Ads Manager از متد executeInParallel برای پردازش حساب‌ها به صورت موازی استفاده کند و یک متد فراخوانی (callback) را مشخص کند، می‌تواند حداکثر تا ۶۰ دقیقه قبل از لغو اجرا شود. این موضوع در شکل زیر نشان داده شده است، که در آن processAccount تابع موازی و allFinished متد فراخوانی هنگام فراخوانی executeInParallel است.

تمام تغییراتی که قبل از لغو اسکریپت ایجاد شده بودند، اعمال خواهند شد.

محدودیت‌های موجودیت

اسکریپت‌های حساب‌های گوگل ادز

  • یک تکرارکننده‌ی واحد به طور پیش‌فرض حداکثر ۵۰۰۰۰ نتیجه را برمی‌گرداند. می‌توانید این را با فراخوانی withLimit() در انتخابگر تغییر دهید.

  • یک سلکتور واحد می‌تواند حداکثر ۱۰،۰۰۰ شناسه را در selector.withIds() مدیریت کند. اگر ۱۰،۰۰۰ شناسه یا بیشتر مشخص شود، selector.get() خطای زمان اجرا ایجاد می‌کند. به طور مشابه، تعیین شرط Id IN [LIST] با لیستی از بیش از ۱۰،۰۰۰ شناسه منجر به خطای زمان اجرا خواهد شد.

  • خروجی ثبت وقایع در ۱۰۰ کیلوبایت کوتاه خواهد شد. در این صورت هشداری ثبت خواهد شد.

اسکریپت‌های حساب‌های مدیریتی

  • هر حساب کاربری که توسط اسکریپت مدیریت تبلیغات پردازش می‌شود، سهمیه‌ی مخصوص به خود را همانطور که در بخش قبلی ذکر شده است، دریافت می‌کند.

  • هنگام استفاده از متد executeInParallel ، یک اسکریپت می‌تواند تا ۵۰ حساب کاربری را پردازش کند.

  • متد processAccount از executeInParallel می‌تواند تا 10 مگابایت داده را برگرداند.

محدودیت‌های آپلود انبوه

  • فایل آپلودی به ۵۰ مگابایت و یک میلیون ردیف محدود شده است و در صورت تجاوز از این محدودیت‌ها، پس از ارسال رد خواهد شد.

  • یک کار آپلود پس از دو ساعت به پایان می‌رسد و پردازش داده‌های باقی‌مانده از فایل آپلود شده را متوقف می‌کند.

سهمیه‌بندی برای سرویس‌های گوگل

سرویس‌های اسکریپت برنامه‌های گوگل، سهمیه‌های روزانه و محدودیت‌های سختی را برای برخی از ویژگی‌ها اعمال می‌کنند. فهرستی از این سهمیه‌ها و پیام‌های استثنای همراه را مشاهده کنید.

اسکریپت‌های مجاز

OAuth2 برای تأیید اسکریپت‌ها استفاده می‌شود. هر حساب کاربری محدودیت ۲۵۰ اسکریپت مجاز دارد. فراتر از این محدودیت، یکی از اسکریپت‌های قبلاً مجاز لغو مجوز می‌شود. این فقط موقتی است و دفعه بعد که اسکریپت باز شود، می‌توان آن را دوباره مجاز کرد.

اگر مرتباً با این محدودیت مواجه می‌شوید، باید استفاده از چندین حساب کاربری را برای مجوزدهی مجموعه‌های مختلف اسکریپت‌ها در نظر بگیرید.

کمپین‌های ویدیویی و خرید

انتخابگر استاندارد کمپین ( AdsApp.campaigns().get() ) کمپین‌های ویدیویی و خرید را از نتایج فیلتر می‌کند. به جای آن از انتخابگرهای اختصاصی کمپین استفاده کنید: