创建和配置 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,请按以下步骤操作:
在 Google API 控制台中打开 API 库。如果系统提示,请选择您的项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
如果列表中没有显示 Google Ads API,请使用搜索功能找到该 API。
选择 Google Ads API,然后点击启用按钮。
配置 OAuth 权限请求页面
当您使用 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 文件。