限制

本頁將列出 Google Ads 指令碼的各種限制，請務必留意。這些限制隨時可能變更，恕不另行通知，因此請確保指令碼具有彈性，並包含錯誤處理機制。

執行時間限制

廣告主帳戶的 Google Ads 指令碼最多可執行 30 分鐘，之後就會取消。系統會套用取消指令碼前所做的所有變更。

Google Ads 管理員帳戶指令碼

廣告管理工具指令碼通常會在最多 30 分鐘後取消。不過，如果 Google Ads 管理工具指令碼使用 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，如果發生這種情況，系統會記錄警告。

管理員帳戶的指令碼

  • 每個由 Google Ads 管理指令碼處理的帳戶，都會獲得如上所述的配額。

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

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

大量上傳限制

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

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

Google 服務配額

部分功能會受到基礎 Google Apps Script 服務的每日配額和硬性限制。請參閱這份配額清單和隨附的例外狀況訊息。

授權指令碼

OAuth2 用來授權指令碼。每個帳戶最多可授權 250 個指令碼。一旦超過限制，系統就會取消授權先前授權的其中一個指令碼。這只是暫時性措施，下次開啟指令碼時可以重新授權。

如果經常遇到這項限制，建議使用多個使用者帳戶授權不同的指令碼集。

影片和購物廣告活動

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