Google Ads 开发者入门核对清单

此核对清单将引导您完成开始使用 Google Ads API 的流程。这些步骤分为多个类别,如果某些步骤不适用于您的需求,您可以选择跳过。如需充分利用本文档,请按顺序阅读并执行步骤。

该列表包含三种类型的项:

待办事项:执行特定任务或设置工具的某个部分所需的步骤。

如果您要打印核对清单,可以使用左侧的复选框标记已完成的步骤。此核对清单提供了 Google Ads API 文档中信息的推荐阅读顺序。

访问和设置

从顶级经理账号的 API 中心获取开发者令牌。您必须填写 API 访问权限表单上的所有字段,并接受条款及条件。请确保您提供的 API 联系电子邮件地址指向的是经常有人查看的收件箱。我们会向您发放一个具有测试账号访问权限级别的开发者令牌。

如需让您的令牌获得正式版权限的批准,您需要填写我们的后续申请表单,并说明您打算如何使用该 API。

您还需要提供设计文档。您可以使用我们的模板来开始创建。请尽可能详细描述。

如果令牌审核团队需要更多信息,会与您联系。如果您在 2 个工作日内未收到任何反馈,也可以通过我们的联系表单与我们联系。

设置客户端库

我们使用 OAuth 2.0 对您针对该 API 的请求进行身份验证。按照 OAuth 2.0 指南中的说明设置 OAuth 2.0 凭据。如需进行问题排查,您可以使用 OAuth 2.0 Playground
我们为部分常用编程语言提供了客户端库。下载您要使用的语言的库,并使用之前获取的凭据设置其配置文件。

开发者令牌 - 访问权限级别

了解访问权限级别,并确定您的工具未来某个时间点是否需要超过每天 15,000 次操作。如果是,您需要申请标准访问权限,以便每天无限制地执行 mutate 操作以及发出 GoogleAdsService.SearchGoogleAdsService.SearchStream 请求。不过,这仍受每天 1,000 次 get 操作的限制。
查看费率表,了解系统如何针对您的访问权限级别计算操作次数。请注意,设置了 page_token 字段的 GoogleAdsService.Search 请求不会计入操作数限制。

最低功能要求 (RMF)

了解最低功能要求 (RMF)。这是指您的工具必须根据其性质实现的一组功能。
请参阅违规费用,了解未正确实施 RMF 会有什么后果。
确保您的工具实现了适用的 RMF。
申请标准权限

开始使用该 API

请参阅发出首次 API 调用,其中介绍了如何使用 API 获取广告系列。所有对象都是以类似的方式可访问的,因此值得记住该结构。
了解资源和服务的 API 结构的基础知识。
请参阅更改和检查对象以及检索对象
请参阅资源元数据,了解如何动态请求资源元数据。
如需制作和管理各种广告系列和广告类型,请参阅广告系列概览

代码示例

基本操作 > 获取广告系列
基本操作 > 获取加大型文字广告
基本操作 > 添加广告系列
基本操作 > 添加关键字
基本操作 > 更新关键字
广告系列管理 > 获取所有被拒登的广告
广告系列管理 > 添加广告系列出价调节系数
账号管理 > 获取账号信息
账号管理 > 创建客户
账号管理 > 获取账号更改

报告

快速浏览报告,并查看示例,了解如何使用 GoogleAdsService 作为 Google Ads 报告中的唯一可信来源,汇总账号在过去 30 天的表现。
请阅读 Google Ads 查询语言 (GAQL),了解查询语法、查询结构以及资源、细分和指标的概念。
如需了解如何使用 *_view 资源(例如 KeywordViewTopicViewGenderView)检索不同条件的效果数据,请参阅条件指标

互动式 Google Ads 查询构建工具

使用此工具中的编辑器,针对特定资源(例如广告组)构建 Google Ads 查询语言语句。将生成的 GAQL 语句复制并粘贴到您的应用中。

关键字研究

如果您不熟悉关键字规划工具,不妨试用一下,了解关键字规划在 Google Ads 界面中的运作方式。

代码示例

规划样本 -> 生成预测指标
规划示例 -> 生成关键字提示

自动设置预算

不妨了解付款方式和设置,了解 Google Ads 中提供的结算选项,例如自动付款、人工付款、按月账单结算(信用额度)。
请参阅结算设置,了解如何以编程方式管理付款资料和付款账号。
不妨了解账号预算,了解如何向账号自动分配预算。
请与您的 Google 企业代表联系,申请注册按月结算。
请与您的 Google 业务代表联系,申请访问 AccountBudgetProposalService
创建 AccountBudgetProposal 并将其分配给账号。尝试将此类预算与广告系列预算结合使用。

购物广告

设置 Merchant Center 账号并获取 MerchantID。
如果您的应用只需要访问您自己的 Merchant Center 账号,请获取服务账号密钥。不过,如果您要编写一种第三方应用,而此应用需要访问客户的 Merchant Center 账号,请参阅向请求授权指南,了解如何使用 OAuth 2.0。
针对您选择的语言下载客户端库
查看适用于 Java.NETPHPPython 等的 Content API 代码示例。
不妨了解如何手动关联 Merchant Center 账号与 Google Ads 账号。
了解如何使用 Content API 设置商品列表
请参阅有关使用 Google Ads API 制作购物广告系列的指南。

建议和更改状态

如果您不熟悉建议更改历史记录功能,不妨在 Google Ads 界面中试用一下。

RecommendationService

请参阅我们的指南,了解如何使用 RecommendationService 检索 Google 的建议并将其应用于您的账号,以提升整体广告效果。
运行以下代码示例,探索建议功能:建议示例 -> 获取文字广告建议

ChangeStatusService

请参阅我们的指南,了解如何使用 ChangeStatusService 检索更改历史记录,以跟踪账号更改(例如广告系列和广告)的情况。
运行以下代码示例,探索更改历史记录功能:ChangeStatus 示例 -> 获取账号更改

随时掌握最新动态

及时了解 Google Ads API 中的变更,确保您的代码保持最新状态。

版本控制

有新 API 发布时,请获取最新版本的客户端库
为最新的版本说明添加书签,并查看每个版本的主要变更。
将对旧版客户端库的调用替换为对新版的调用。
关注此博客,订阅我们的 RSS Feed,以便通过电子邮件接收博文,并查看论坛,获取有关 Google Ads API 的最新信息。
请确保您在主要经理账号的 API 中心中注册的 API 联系电子邮件地址是最新的,因为如果我们发现与您使用 API 相关的任何技术问题,都会通过该地址与您联系。
Google Merchant Center Google Merchant Center 可帮助您将商店和商品数据上传到 Google,并用于购物广告和其他 Google 服务。
商家资料 商家资料可帮助您在 Google 搜索和 Google 地图上吸引本地客户并与他们互动。
Google Analytics Google Analytics 可提供有关用户如何使用您网站的深入报告。 您可以使用 Google Analytics 了解用户在点击您的广告后所执行的操作。
Google 跟踪代码管理器 Google 跟踪代码管理器是一个跟踪代码管理系统 (TMS),可以帮助您快速更新网站或移动应用上的跟踪代码及相关代码段(统称为“代码”)。
Google 优化工具 Google 优化工具为小型企业提供 A/B 测试、网站测试和个性化工具,帮助他们提供富有吸引力的客户体验。
Google 数据洞察 数据洞察可以将您的数据转换成详实、易于阅读和分享且可完全自定义的信息中心和报告。

获取帮助

Google Ads API 指南添加书签。其中详细介绍了大多数基本概念。
Google Ads API 参考文档添加书签。该文档详细介绍了该 API 的所有功能。
Google Ads API 支持页面添加书签,其中介绍了主要的支持渠道。
欢迎访问 Google Ads 开发者 YouTube 频道
请与您的 Google 业务代表 / 合作伙伴经理联系,安排会议来解决与该 API 相关的更复杂的战略问题。