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 或第三方 API 集成到我的 Google Ads 管理中。 | 将 Google API 或 第三方 API 与 Google Ads 脚本搭配使用。 |
内置的 Google Workspace 服务（Google 表格、云端硬盘、邮件）、高级 Google API（BigQuery、Analytics、YouTube）和 UrlFetchApp 用于 外部 REST API。 |
| 我是一名数据分析师（或类似角色），想要下载 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 上与我们 联系。
如果您需要支持， 请与脚本技术支持团队联系。