Google Ads 脚本提供了一个无服务器自动化平台，让您可以在基于浏览器的 IDE 中使用现代 JavaScript (ES6+) 以程序化方式管理和查询 Google Ads 广告数据。借助 Google Ads 脚本，您可以自动执行日常账号管理工作流、生成自定义报告，并将 Google Ads 与外部数据源集成（涵盖一个账号或数千个账号），而无需预配服务器或管理开发者凭据。
Google Ads 的大多数功能都可通过 mutate 和 search 调用在 Google Ads 脚本中使用。您可以使用脚本进行以下操作：
- 管理广告系列、广告组、关键字和广告。
- 根据实时效果或外部数据调整出价、预算和状态。
- 使用 Google Ads 查询语言 (GAQL) 运行查询，以生成自定义报告和信息中心。
- 安排自动执行，使其每小时、每天、每周、每月或按需运行。
- 使用经理脚本跨子账号协调多账号操作。
- 连接到 Google Workspace 服务（例如 Google 表格和云端硬盘）、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 API 或第三方 API 与 Google Ads 脚本搭配使用。 |
内置 Google Workspace 服务（表格、云端硬盘、邮件）、高级 Google API（BigQuery、Google Analytics、YouTube）以及用于外部 REST API 的 UrlFetchApp。
|
| 我是一名数据分析师（或类似角色），想要下载 Google Ads 报告以进行进一步分析。 | 使用适用于 Google Ads 的 BigQuery Data Transfer Service。 | 无需编写代码，即可将 Google Ads 广告数据自动按计划导入 BigQuery。 |
| 我想批量管理 Google Ads，并且不介意编写代码。 | 将批量上传与 Google Ads 脚本结合使用。 | 程序化 CSV 或电子表格上传，最多支持 1,000,000 行。 |
| 我想批量管理 Google Ads，但不想编写任何代码。 | 使用自动规则、批量上传或 Google Ads 编辑器。 | 用于批量更新和预设规则的无代码桌面或界面工具。 |
前提条件
您只需具备 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 上与我们联系。
如果您需要支持，请与脚本技术支持团队联系。