设置 Google API 控制台项目

创建和配置 Google API 控制台项目时要遵循的步骤取决于您要在应用中构建的 OAuth 2.0 授权方案的类型。选择您要构建的授权方案;本指南将根据您的选择进行自定义。

您需要一个 Google API 控制台项目,才能创建 OAuth 2.0 凭据并为您的应用启用 Google Ads API。

Google 服务器需要这些凭据来对 Google Ads 用户进行身份验证和授权。借助这些凭据,您可以生成 OAuth 令牌,以便在调用 API 时使用。

虽然您可以为多个项目使用一个开发者令牌,但每个项目只能使用一个开发者令牌。

选择或创建 Google API 控制台项目

按照说明创建项目。为项目启用结算功能是可选操作。如果您已启用结算功能,请为新项目选择一个结算账号。使用 Google Ads API 无需支付任何费用,不过,会对 Google Cloud 项目的总数有配额限制。

在项目中启用 Google Ads API

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

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

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

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

启用 Google Ads API

当您使用 OAuth 2.0 进行授权时,Google 会向用户显示权限请求页面,其中包括项目摘要、项目政策以及请求的访问授权范围。通过配置应用的 OAuth 权限请求页面,您可以定义向用户和应用审核者显示哪些内容,还可以注册应用以便以后发布。

按照说明为您的应用配置 OAuth 权限请求页面,并添加 https://www.googleapis.com/auth/adwords 作为 OAuth 范围。

用户类型和发布状态方面的重要注意事项

配置 OAuth 权限请求页面时,请注意用户类型发布状态设置。

  • 用户类型:用于定义您的应用是仅限组织内的用户使用(“内部”),还是可供任何 Google 用户使用(“外部”)。请注意,只有当您的项目属于 Google Workspace 组织时,才能选择“内部”。
  • 发布状态:确定应用是处于“测试”模式(仅限您添加的特定测试用户)还是“正式版”模式(面向“用户类型”定义的受众群体提供,可能需要 Google 进行应用验证)。

如需为您的应用做出最佳选择,请查看官方 Google Cloud 支持文档中对这些设置的详细说明和影响:

了解这些设置对于确保您的应用可供目标用户访问至关重要。

创建客户端 ID 和客户端密钥

如果您使用的是现有的 Google API 控制台项目,并且该项目已生成客户端 ID 和客户端密钥,则可以跳过此步骤。否则,请按照说明创建客户端 ID 和客户端密钥。 您可以选择桌面应用Web 应用作为应用类型。创建 OAuth 2.0 客户端后,请先点击其 Download OAuth client(下载 OAuth 客户端)图标,然后在随后显示的界面上点击 DOWNLOAD JSON(下载 JSON)按钮,下载客户端的 JSON 文件。