Google Ads 指令碼提供無伺服器自動化平台，可讓您在瀏覽器型 IDE 中，使用新版 JavaScript (ES6+) 以程式輔助方式管理及查詢 Google Ads 廣告資料。您可以使用 Google Ads 指令碼，自動執行例行帳戶管理工作流程、產生自訂報表，以及將 Google Ads 與外部資料來源整合，不必佈建伺服器或管理開發人員憑證，就能在一個或數千個帳戶中執行這些操作。
Google Ads 的大部分功能，都可透過 mutate 和 search 呼叫，在 Google Ads 指令碼中使用。指令碼可用於：
- 管理廣告活動、廣告群組、關鍵字和廣告。
- 根據即時成效或外部資料，調整出價、預算和狀態。
- 使用 Google Ads 查詢語言 (GAQL) 執行查詢，產生自訂報表和資訊主頁。
- 排定自動執行頻率：每小時、每天、每週、每月或隨選。
- 使用管理員指令碼，在子帳戶中協調多帳戶作業。
- 連結 Google Workspace 服務 (例如試算表和雲端硬碟)、Google Cloud 服務 (例如 BigQuery) 和第三方 API。
主要技術規格
下列技術規格定義了 Google Ads 指令碼的執行環境和作業限制：
| 規格 | 單一帳戶指令碼 | 管理員帳戶指令碼 |
|---|---|---|
| 執行逾時 | 最長 30 分鐘 |
executeInParallel和回撥最長 60 分鐘 (標準為 30 分鐘) |
| 執行階段引擎 | V8 JavaScript 執行階段 (ECMAScript 6 以上版本) | V8 JavaScript 執行階段 (ECMAScript 6+) |
| 實體迭代器限制 | 每個疊代器預設為 50,000 個實體 (報表和搜尋查詢除外) | 每個子帳戶最多 50,000 個實體 (報表和搜尋查詢除外) |
| 平行帳戶 | 不適用 (1 個帳戶) | 最多可同時遷移 50 個帳戶 |
| 大量上傳限制 | 檔案大小 50 MB，1,000,000 列 | 檔案大小 50 MB，1,000,000 列 |
| 授權指令碼 | 每位使用者最多可授權 250 個指令碼 | 每位使用者最多可授權 250 個指令碼 |
| 代管和基礎架構 | 由 Google 全代管 (無伺服器) | 由 Google 全代管 (無伺服器) |
詳情請參閱「限制」。
Google Ads 指令碼適合我嗎？
Google 提供多項產品，協助您自動管理 Google Ads 帳戶。下表列出常見情境和建議，協助您選擇最符合需求的產品：
| 情境 | 建議 | 主要特色 |
|---|---|---|
| 我是開發人員，希望建構自己的軟體產品，或整合 Google Ads API。我擅長編寫程式碼，並管理軟體基礎架構，包括伺服器和資料庫。 | 使用 Google Ads API。 | 完整的 API 控制權、更高的處理量、專屬代管服務和 OAuth 管理。 |
| 我是開發人員，習慣編寫程式碼，但不想管理自己的軟體基礎架構。 | 使用 Google Ads 指令碼。 | 在 Google Ads 中無伺服器執行、自動排程、瀏覽器式 IDE。 |
| 我不是開發人員，但願意花時間學習程式設計，以便自動管理 Google Ads。 | 使用 Google Ads 指令碼。 | 簡單的 JavaScript 語法、預先建構的指令碼範本、IDE 自動完成和語法醒目顯示功能。 |
| 我想以程式輔助方式管理影片廣告活動。 | 使用 Google Ads 指令碼。 |
使用 AdsApp.videoCampaigns() 直接管理影片廣告活動。 |
| 我想排定工作，在沒有活躍使用者工作階段的情況下執行。 | 使用 Google Ads 指令碼。 | OAuth2 背景授權，可自動排定每小時、每天、每週或每月的授權時間。 |
| 我想透過程式輔助方式存取巢狀 Google Ads 帳戶。 | 使用管理員指令碼，透過單一指令碼存取放送子帳戶。 |
在子帳戶之間依序疊代，或使用 executeInParallel，在最多 50 個子帳戶之間平行執行。 |
| 我想將 Google 或第三方的 API 整合至 Google Ads 管理服務。 | 搭配 Google Ads 指令碼使用 Google API 或第三方 API。 |
內建的 Google Workspace 服務 (試算表、雲端硬碟、郵件)、進階 Google API (BigQuery、Analytics、YouTube)，以及UrlFetchApp外部 REST API。 |
| 我是資料分析師 (或類似角色)，想下載 Google Ads 報表進行進一步分析。 | 使用 Google Ads 適用的 BigQuery 資料移轉服務。 | 排定自動化管道，將 Google Ads 廣告資料移至 BigQuery，不需編寫程式碼。 |
| 我想大量管理 Google Ads，且不介意編寫程式碼。 | 搭配 Google Ads 指令碼使用大量上傳功能。 | 程式輔助 CSV 或試算表上傳，最多支援 1,000,000 列。 |
| 我想大量管理 Google Ads，但不想撰寫任何程式碼。 | 使用自動規則、大量上傳或 Google Ads 編輯器。 | 無程式碼的電腦版或 UI 工具，可大量更新及排定規則。 |
必要條件
您只需要具備 JavaScript 的入門知識，IDE 會協助您醒目顯示語法、自動完成和預覽。只要有 Google Ads 帳戶，就能開始編寫第一個指令碼。
常見問題
查看 Google Ads 指令碼架構、執行限制和整合的常見問題解答。
什麼是 Google Ads 指令碼？
Google Ads 指令碼可在 Google Ads 中提供無伺服器自動化環境。廣告主和開發人員可透過這些函式庫編寫 JavaScript 程式碼，查詢成效指標、建立及修改廣告活動、更新出價和預算，以及連線至外部 API，不必設定伺服器、管理 OAuth 權杖或支付基礎架構費用。
Google Ads 指令碼與 Google Ads API 有何不同？
Google Ads 指令碼會使用 JavaScript 直接在 Google Ads 帳戶中執行，不需要伺服器基礎架構，且會在瀏覽器中自動處理授權。Google Ads API 是 REST 和 gRPC API，專為在您自己的伺服器上執行的大型企業應用程式、第三方工具和大量資料管道而設計，需要專屬的開發人員權杖和 OAuth 憑證。
我需要伺服器才能執行 Google Ads 指令碼嗎？
不會。Google Ads 指令碼完全在 Google 的雲端基礎架構上執行，不需額外付費。您可以直接在 Google Ads 網頁介面中編寫指令碼、使用預覽模式測試，以及排定執行時間。
Google Ads 指令碼的執行限制為何？
個別帳戶中的標準指令碼每次執行最多 30 分鐘。使用 executeInParallel 的管理員帳戶指令碼，最多可在 50 個子帳戶中執行 60 分鐘 (如果指定回呼函式)。如果指令碼逾時，Google Ads 仍會套用取消前所做的任何變更。如要進一步瞭解逾時、配額和大量上傳限制，請參閱「限制」。
Google Ads 指令碼可以連結外部 API 嗎？
可以。Google Ads 指令碼包含內建服務，例如用於讀取和寫入 Google 試算表的 SpreadsheetApp、用於向外部 REST API 傳送 HTTP 要求的 UrlFetchApp，以及用於與 BigQuery 和 YouTube 等服務整合的進階 Google API。詳情請參閱「第三方 API」和「進階 Google API」。
意見回饋
如果您對 Google Ads 指令碼有任何意見，歡迎與我們分享！歡迎透過 Discord 與我們聯絡。
如需支援，請與指令碼技術支援團隊聯絡。