创建和配置 Google API 控制台项目的方式取决于应用的 OAuth 2.0 授权方案。选择一个授权方案, 以便自定义本指南。
您需要一个 Google API 控制台项目,才能创建 OAuth 2.0 凭据并为您的应用启用 Google Ads API。
这些凭据用于在 Google 服务器上对您的应用或 Google Ads 用户进行身份验证和授权,并允许您生成 OAuth 令牌以用于对 API 的调用。
选择或创建 Google API 控制台项目
如需设置新项目,请按照指南创建 Google API 控制台项目。为项目启用结算功能是可选操作。如果您已启用结算功能,请为新项目选择结算账号。使用 Google Ads API 不会产生任何费用,但 Cloud 项目会受到标准项目配额限制。
在项目中启用 Google Ads API
如需在您的项目中启用 Google Ads API,请按以下步骤操作:
在 Google API 控制台中打开 API 库。如果系统提示,请选择您的项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
如果列表中没有显示 Google Ads API,请使用搜索功能查找该 API。
选择 Google Ads API,然后点击启用按钮。
申请 API 访问权限
接下来,访问 Google Ads API 概览页面,查看您当前的 API 访问权限级别。如果您的当前 API 访问权限级别为测试,请展开升级访问权限级别部分。按照说明申请探索者访问权限级别。
您完成申请后,Google 会自动审核您的申请,并在大多数情况下将您的访问权限升级为探索者访问权限。
配置 OAuth 权限请求页面
当您使用 OAuth 2.0 进行授权时,Google 会向用户显示权限请求页面,其中包含项目摘要、项目政策以及请求的访问授权范围。通过配置应用的 OAuth 权限请求页面,您可以定义向用户和应用审核者显示哪些内容,还可以注册应用以便以后发布。
为应用配置 OAuth 权限请求页面,并添加 https://www.googleapis.com/auth/adwords 作为 OAuth 范围。
用户类型和发布状态方面的重要注意事项
配置 OAuth 权限请求页面时,请注意用户类型和发布状态设置。
- 用户类型:用于定义您的应用是否仅限组织内的用户使用(内部),还是可供任何 Google 用户使用(外部)。只有当您的项目属于 Google Workspace 组织时,才能使用内部。
- 发布状态:决定应用是处于测试模式(仅限您添加的特定测试用户)还是正式版(面向由用户类型定义的受众群体发布,可能需要 Google 进行应用验证)。
如需为您的应用做出最佳选择,请查看 Google Cloud 官方支持文档中对这些设置的详细说明和影响:
了解这些设置对于确保您的应用可供目标用户使用至关重要。
创建客户端 ID 和客户端密钥
创建客户端 ID 和客户端密钥。您可以选择桌面应用或 Web 应用作为应用类型。创建 OAuth 2.0 客户端后,点击确认对话框中的下载 JSON 按钮,下载客户端的 JSON 文件。