本頁概述 Google Ads 指令碼的各種限制,這些限制可能隨時變更,恕不另行通知,因此請確保指令碼具有彈性,並包含錯誤處理機制。
執行時間限制
Google Ads 指令碼
廣告主帳戶的 Google Ads 指令碼最多可執行 30 分鐘,超過這個時間就會取消。指令碼取消前所做的所有變更都會套用。
Ads Manager 指令碼
Ad 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()) 會從結果中篩除影片和購物廣告活動。請改用專屬的廣告活動選取器: