设置 Google API 控制台项目

创建和配置 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 不会产生任何费用,但云项目会受到标准项目配额限制。

在项目中启用 Google Ads API

如需在项目中启用 Google Ads API,请按以下步骤操作:

  1. 在 Google API 控制台中打开 API 库。如果系统提示,请选择您的项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。

  2. 如果列表中没有显示 Google Ads API ,请使用搜索功能查找该 API。

  3. 选择 Google Ads API ,然后点击 启用 按钮。

启用 Google Ads API

申请 API 访问权限

接下来,请访问 Google Ads API 概览 页面,查看您当前的 API 访问权限级别。如果当前的 API 访问权限 级别为 测试 ,请展开升级访问权限级别 部分。按照说明申请 Explorer 访问权限级别。

提交申请后,Google 会在大多数情况下自动审核您的申请,并将其升级为 Explorer 访问权限。

当您使用 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 文件。