有兴趣分享您对 Google Ads API 的反馈吗?
注册即可获邀参与用户调研!
准备客户帐号
在此步骤中,您需要确定要进行 API 调用的 Google Ads 帐号。您需要使用其电子邮件地址来生成 OAuth 2.0 刷新令牌。该帐号可以是生产(实时)帐号,也可以是测试帐号。每种方法都有自己的优缺点。
|
生产账号 |
测试账号 |
优点 |
- 更轻松地编写和测试适用于特定帐号内容的代码。
- 更轻松地编写和测试处理实时报告数据的代码。
|
- 测试帐号不会投放广告,因此编程错误不会影响您的已投放广告系列。
- 适用于具有测试访问权限级别的开发者令牌。
|
缺点 |
- 开发阶段的编程错误可能会影响广告系列的实际投放,导致广告系列效果不佳、投放错误或财务损失等问题。
- 开发者令牌至少应具有基本访问权限级别,才能进行 API 调用。
|
- 您需要在测试帐号中重构广告系列,以测试适用于特定帐号内容的代码。
- 由于测试帐号不投放广告,因此与实时投放相关的功能(例如报告统计信息、违反政策错误或处理线下转化数据导入)也不受支持,因此很难测试这些功能。
|
我们建议您在开发应用时尽可能使用测试帐号。有关说明,请参阅创建测试帐号和广告系列。
另一种方法是为测试帐号不支持的功能明确设置一个帐号预算较低(如 1 美元/天)的生产帐号。
特征集选择
选择用于进行 API 调用的帐号时,还需要考虑您希望通过 API 使用哪些功能。即使您选择使用生产帐号,一些功能还是特定于帐号的,例如:
- 要使用结算功能,您需要一个采用按月账单结算方式的账号。
- 部分新功能可能只有列入许可名单的账号才能使用。
在最终确定用于发出 API 调用的帐号之前,请查看特定功能的文档,以确保该功能没有其他限制。
用户访问权限、登录客户 ID 和客户 ID
如需对 Google Ads 客户进行 API 调用,您需要直接或通过关联的经理帐号访问该客户。您还需要适当的权限,具体取决于特定 API 调用。
登录 Google Ads 时,您可能有多个客户账号可供选择。您选择的帐号会建立登录客户 ID(某些 API 调用的必需标头)以及您的访问权限级别。
在确定要向其发出 API 调用的 Google Ads 客户后,请注意以下详细信息:
您计划对其发出 API 调用的客户帐号的 10 位数客户 ID。有时也称为操作客户。
您所登录的客户帐号的电子邮件地址。生成 OAuth 2.0 刷新令牌时需要使用此文件。
您所登录的客户帐号的 10 位数登录客户 ID。
如果您登录的是运营客户,则登录客户 ID 与客户 ID 相同。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-06-26。
[null,null,["最后更新时间 (UTC):2024-06-26。"],[[["Choose a Google Ads account (production or test) to make API calls, noting its email address for generating OAuth 2.0 refresh tokens."],["Test accounts are recommended for development to prevent affecting live campaigns; however, they don't support features related to live serving."],["Production accounts, with a low budget, can be used to test features unsupported by test accounts, but a programming bug can affect live campaigns."],["Ensure the selected account supports the desired features as some features have account-specific restrictions."],["To make API calls, you need access to the customer account, the 10-digit customer ID, email address for OAuth 2.0 token generation, and the 10-digit login customer ID."]]],[]]