با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه محدودیت‌ها و محدودیت‌های مختلفی را در اسکریپت‌های Google Ads نشان می‌دهد که باید از آنها آگاه باشید. این محدودیت‌ها می‌توانند در هر زمان بدون هشدار تغییر کنند، بنابراین اطمینان حاصل کنید که اسکریپت‌های شما انعطاف‌پذیر هستند و حاوی رسیدگی به خطا هستند.
محدودیت های زمانی اجرا
اسکریپت های تبلیغات گوگل
اسکریپت‌های Google Ads برای حساب‌های تبلیغ‌کننده می‌توانند حداکثر 30 دقیقه اجرا شوند و پس از آن لغو خواهند شد. همه تغییرات ایجاد شده قبل از لغو اسکریپت اعمال خواهند شد.
اسکریپت های مدیر تبلیغات
اسکریپت‌های Ads Manager معمولاً می‌توانند حداکثر تا 30 دقیقه اجرا شوند و پس از آن لغو می‌شوند. با این حال، اگر یک اسکریپت Ads Manager از متد executeInParallel برای پردازش حساب‌ها به صورت موازی استفاده کند و یک روش بازگشت به تماس را مشخص کند، می‌تواند حداکثر تا 60 دقیقه قبل از لغو شدن اجرا شود. این در شکل زیر نشان داده شده است، جایی که processAccount تابع موازی است، و allFinished روش بازگشت به تماس هنگام فراخوانی executeInParallel است.
همه تغییرات ایجاد شده قبل از لغو اسکریپت اعمال خواهند شد.
محدودیت های موجودیت
اسکریپت های حساب های تبلیغاتی گوگل
یک تکرار کننده به طور پیش فرض حداکثر 50000 نتیجه برگردانده می شود. شما می توانید با فراخوانی withLimit() در انتخابگر این مورد را تغییر دهید.
یک انتخابگر می تواند حداکثر 10000 شناسه را در selector.withIds() مدیریت کند. اگر 10000 شناسه یا بیشتر مشخص شود، selector.get() یک خطای زمان اجرا ایجاد می کند. به طور مشابه، مشخص کردن یک شرط Id IN [LIST] با لیستی از شناسه ها
10000 منجر به خطای زمان اجرا می شود.
خروجی ورود به سیستم در 100 کیلوبایت کوتاه خواهد شد. در صورت وقوع یک هشدار ثبت می شود.
اسکریپت حساب های مدیر
هر حسابی که توسط یک اسکریپت Ads Manager پردازش می‌شود، سهمیه خاص خود را همانطور که در بالا ذکر شد دریافت می‌کند.
هنگام استفاده از روش executeInParallel ، یک اسکریپت می تواند تا 50 حساب را پردازش کند.
متد processAccount از executeInParallel می تواند تا 10 مگابایت داده را برگرداند.
محدودیت های آپلود انبوه
فایل آپلود محدود به 50 مگابایت و یک میلیون ردیف است و در صورت تجاوز از این محدودیت ها، پس از ارسال رد می شود.
کار آپلود پس از دو ساعت تمام می شود و کار پردازش هرگونه داده باقی مانده از فایل آپلود شده را متوقف می کند.
سهمیه خدمات Google
سرویس‌های زیربنایی Google Apps Script سهمیه‌های روزانه و محدودیت‌های سختی را برای برخی ویژگی‌ها اعمال می‌کنند. فهرستی از این سهمیه ها و پیام های استثنایی همراه را ببینید.
اسکریپت های مجاز
OAuth2 برای مجوز دادن به اسکریپت ها استفاده می شود. هر حساب دارای محدودیت 250 اسکریپت مجاز است. فراتر از این محدودیت، یکی از اسکریپت‌های مجاز قبلی لغو مجوز می‌شود. این فقط موقتی است و دفعه بعد که اسکریپت باز می شود می توان آن را مجدداً تأیید کرد.
اگر اغلب با این محدودیت مواجه هستید، باید از چندین حساب کاربری برای مجوز دادن به مجموعه‌های مختلف اسکریپت استفاده کنید.
کمپین های ویدیویی و خرید
انتخابگر کمپین استاندارد ( AdsApp.campaigns().get() ) کمپین های ویدیویی و خرید را از نتایج فیلتر می کند. به جای آن از انتخابگرهای اختصاصی کمپین استفاده کنید:
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Ads scripts have an execution time limit of 30 minutes, while Ads Manager scripts can run for up to 60 minutes when using \u003ccode\u003eexecuteInParallel\u003c/code\u003e with a callback method.\u003c/p\u003e\n"],["\u003cp\u003eScripts for advertiser accounts have entity limits, including a 50,000 result limit per iterator, a 10,000 ID limit per selector, and a 100Kb logging output limit.\u003c/p\u003e\n"],["\u003cp\u003eAds Manager scripts have additional limits for processing accounts in parallel, with a maximum of 50 accounts and a 10MB data return limit for the \u003ccode\u003eprocessAccount\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eBulk uploads are restricted to files under 50MB and one million rows, with a two-hour timeout for processing.\u003c/p\u003e\n"],["\u003cp\u003eEach Google Ads account can authorize up to 250 scripts, and exceeding this limit will temporarily deauthorize older scripts.\u003c/p\u003e\n"]]],[],null,["# Limits\n\nThis page outlines various limits and limitations in Google Ads scripts that you\nshould be aware of. These limits can change at any time without warning, so\nensure that your scripts are flexible and contain error handling.\n\nExecution time limits\n---------------------\n\n### Google Ads scripts\n\nGoogle Ads scripts for advertiser accounts can execute for a **maximum of 30\nminutes**, after which they will be cancelled. All of the changes made\nbefore the script was cancelled will be applied.\n\n### Ads Manager scripts\n\nAds Manager scripts can normally execute for a **maximum of 30 minutes** after\nwhich they will be cancelled. However, if an Ads Manager script uses the\n[`executeInParallel`](/google-ads/scripts/docs/reference/adsmanagerapp/adsmanagerapp_managedaccountselector#executeInParallel_2)\nmethod to process accounts in parallel, and specifies a callback method, then it\ncan execute up to a **maximum of 60 minutes** before being cancelled. This is\nillustrated in the following figure, where `processAccount` is the parallel\nfunction, and `allFinished` is the callback method when calling\n[`executeInParallel`](/google-ads/scripts/docs/reference/adsmanagerapp/adsmanagerapp_managedaccountselector#executeInParallel_2).\n\nAll of the changes made before the script was cancelled will be applied.\n\nEntity limits\n-------------\n\n| **Note:** [Reports](/google-ads/scripts/docs/features/reports) are not subject to any entity limits.\n\n### Scripts of Google Ads accounts\n\n- A single **iterator** will default to at most 50,000 results returned. You\n can modify this by calling `withLimit()` on the selector.\n\n- A single **selector** can handle at most 10,000 IDs in `selector.withIds()`.\n If 10,000 or more IDs are specified, `selector.get()` will throw a runtime\n error. Similarly, specifying an `Id IN [LIST]` condition with a list of IDs\n\n \u003e 10,000 will result in a runtime error.\n- Logging output will be truncated at 100Kb. A warning will be logged if that\n happens.\n\n### Scripts of manager accounts\n\n- Each account processed by an Ads Manager script gets its own quota as [listed\n above](#scripts_of_google_ads_accounts).\n\n- When using the `executeInParallel` method, a script can process up to **50**\n accounts.\n\n- The `processAccount` method from `executeInParallel` can return up to\n **10MB** of data.\n\nBulk upload limits\n------------------\n\n- The upload file is limited to 50MB and one million rows, and will be rejected\n upon submission if it exceeds these limits.\n\n- An upload job times out after two hours and the job will stop processing any\n remaining data from the uploaded file.\n\nQuotas for Google services\n--------------------------\n\nThe underlying Google Apps Script services impose daily quotas and hard limits\non some features. See a list of these\n[quotas and accompanying exception messages](/apps-script/guides/services/quotas).\n| **Key Point:** To get around the \"Exceeded maximum execution time\" error, you can reschedule your script under multiple user accounts to extend the script's quota.\n\nAuthorized scripts\n------------------\n\nOAuth2 is used to authorize scripts. Each account has a limit of **250**\nauthorized scripts. Beyond that limit, one of the previously authorized\nscripts will be deauthorized. This is only temporary, and the script can be\nreauthorized the next time it is opened.\n\nIf you are frequently running into this limit, you should consider using\nmultiple user accounts to authorize different sets of scripts.\n\nVideo and shopping campaigns\n----------------------------\n\nThe standard campaign selector (`AdsApp.campaigns().get()`) will filter\nout [video](//support.google.com/google-ads/answer/2375497) and\n[shopping](//support.google.com/google-ads/answer/3455481) campaigns\nfrom the results. Use the dedicated campaign selectors instead:\n\n- [`videoCampaignSelector.get()`](/google-ads/scripts/docs/reference/adsapp/adsapp_videocampaignselector)\n- [`shoppingCampaignSelector.get()`](/google-ads/scripts/docs/reference/adsapp/adsapp_shoppingcampaignselector)"]]
