限制

本頁將概略說明 Google Ads 指令碼的各種限制,供您參考。這些限制可能隨時變更,恕不另行通知,因此請確保指令碼具備彈性,並包含錯誤處理機制。

執行時間限制

廣告主帳戶的 Google Ads 指令碼執行時間最多為 30 分鐘,超過時間就會取消。系統會套用取消指令前所做的所有變更。

Ad Manager 指令碼

Ad Manager 指令碼通常可執行 最多 30 分鐘,之後就會取消。不過,如果 Ad Manager 指令碼使用 executeInParallel 方法並指定回呼方法,則可在取消前執行 最多 60 分鐘。下圖說明這項情況,其中 processAccount 是平行函式,allFinished 是呼叫 executeInParallel 時的回呼方法。

取消之前已完成的所有修改都會生效。

實體限制

Google Ads 帳戶的指令碼

  • 單一 迭代器預設會傳回最多 50,000 個結果。您可以透過在選取器上呼叫 withLimit() 來修改此值。

  • 單一 selector 最多可在 selector.withIds() 中處理 10,000 個 ID。如果指定的 ID 超過 10,000 個,selector.get() 就會擲回執行階段錯誤。同樣地,請使用 ID 清單指定 Id IN [LIST] 條件

    10,000 會導致執行階段錯誤。

  • 紀錄結果會縮為 100Kb,發生這種情況時,系統會記錄警告。

管理員帳戶的劇本

  • 每個由 Ad Manager 指令碼處理的帳戶都會獲得上述的配額。

  • 使用 executeInParallel 方法時,指令碼最多可處理 50 個帳戶。

  • executeInParallelprocessAccount 方法最多可傳回 10 MB 的資料。

大量上傳限制

  • 上傳檔案大小上限為 50 MB,列數上限為一百萬列,如果超過這些限制,系統會在提交時拒絕。

  • 上傳工作會在兩小時後逾時,並停止處理上傳檔案中的任何剩餘資料。

Google 服務配額

基礎 Google Apps Script 服務會對部分功能設定每日配額和硬性限制。如需這些配額和隨附的例外狀況訊息清單,請參閱這個頁面

授權指令碼

OAuth2 用來授權指令碼。每個帳戶最多可有 250 個授權指令碼。超過此限制後,系統會將先前授權的其中一個指令碼撤銷授權。這只是暫時性的,下次開啟時,指令碼就可以重新授權。

如果經常遇到這個限制,建議您使用多個使用者帳戶來授權不同的指令碼組合。

影片和購物廣告活動

標準廣告活動選取器 (AdsApp.campaigns().get()) 會從結果中篩除影片購物廣告活動。請改用專屬廣告活動選擇器: