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 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)，以及用於外部 REST API 的 UrlFetchApp。 |
| 我是資料分析師 (或類似角色)，想下載 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 與我們聯絡。
如需支援，請與指令碼技術支援團隊聯絡。