本頁將列出 Google Ads 指令碼的各種限制,請務必瞭解。這些限制可能隨時變更,恕不另行通知,因此請確保指令碼具有彈性,並包含錯誤處理機制。
執行時間限制
Google Ads 指令碼
廣告主帳戶的 Google Ads 指令碼最多可執行 30 分鐘,超過這個時間就會取消。系統會套用取消指令碼前所做的變更。
Ads Manager 指令碼
廣告管理工具指令碼通常最多可執行 30 分鐘,之後就會取消。不過,如果 Google Ads 管理員指令碼使用 executeInParallel 方法平行處理帳戶,並指定回呼方法,則最多可執行 60 分鐘,之後才會取消。如下圖所示,processAccount 是平行函式,而 allFinished 是呼叫 executeInParallel 時的回呼方法。

系統會套用取消指令碼前所做的所有變更。
實體限制
Google Ads 帳戶指令碼
單一疊代器預設最多會傳回 50,000 筆結果。如要修改這項設定,請在選取器上呼叫
withLimit()。單一選取器在
selector.withIds()中最多可處理 10,000 個 ID。如果指定 10,000 個以上的 ID,selector.get()會擲回執行階段錯誤。同樣地,如果指定Id IN [LIST]條件,且清單包含超過 10,000 個 ID,則會發生執行階段錯誤。紀錄結果會縮為 100Kb,如果發生這種情況,系統會記錄警告。
管理員帳戶的指令碼
每個由 Google Ads 管理員指令碼處理的帳戶,都會獲得如上一節所述的配額。
使用
executeInParallel方法時,指令碼最多可處理 50 個帳戶。executeInParallel的processAccount方法最多可傳回 10 MB 的資料。
大量上傳限制
上傳檔案的大小上限為 50 MB,列數上限為 100 萬列,超過這些限制就會遭拒。
上傳工作會在兩小時後逾時,並停止處理上傳檔案中的任何剩餘資料。
Google 服務配額
基礎 Google Apps Script 服務會對某些功能設定每日配額和硬性限制。請參閱配額和隨附例外狀況訊息清單。
授權指令碼
OAuth2 用來授權指令碼。每個帳戶最多可有 250 個授權指令碼。超過限制後,系統會取消授權先前授權的指令碼。這只是暫時性的,下次開啟指令碼時可以重新授權。
如果經常達到這項上限,建議使用多個使用者帳戶,為不同指令碼組合授權。
影片和購物廣告活動
標準廣告活動選取器 (AdsApp.campaigns().get()) 會從結果中篩除影片和購物廣告活動。請改用專屬廣告活動選擇器: