设置 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 和客户端密钥

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