您需要一个 Google API 控制台项目,以便创建 OAuth 2.0 凭据、配置用户意见征求屏幕以及为您的应用启用 Google Ads API。
Google 服务器在对 Google Ads 用户进行身份验证和授权时需要使用这些凭据。通过这些凭据,您可以生成 OAuth 令牌,以便在调用 API 时使用。
选择或创建 Google API 控制台项目
如果您已有 Google API 控制台项目并希望使用它来创建凭据,则可以跳至创建客户端 ID 和客户端密钥。
如需创建项目,请执行以下操作:
- 转到 Google API 控制台
- 点击创建项目
- 输入名称或接受生成的建议
- 确认或修改其余所有字段
- 点击创建
如果您已启用结算功能,请为新项目选择结算帐号。使用 Google Ads API 无需付费,但对 Cloud 项目总数有配额限制。
配置 OAuth 权限请求页面
如果您使用的是现有 Google API 控制台项目,并且之前已配置 OAuth 权限请求页面,则可以跳过此步骤,改为通过添加 Google Ads API OAuth 2.0 范围来修改权限请求页面。
当您使用 OAuth 2.0 进行授权时,Google 会向用户显示同意屏幕,其中包括项目摘要、其政策和所请求的访问授权范围。通过配置应用的 OAuth 权限请求页面,您可以定义要向用户显示的内容和应用审核者的内容,并注册您的应用以便日后发布。
配置新的 OAuth 同意屏幕
- 打开 “同意屏幕”页面,然后在页面顶部的下拉菜单中选择您的项目。
- 选择用户类型,然后点击创建。
- 填写同意屏幕表单。您以后可以根据需要进行修改。 完成后,点击保存并继续。
- 在下一页上,点击添加或删除脚本。
- 向下滚动,然后在手动添加范围下的字段中输入以下内容:
https://www.googleapis.com/auth/adwords
- 点击添加到表。
- 添加您的项目可能需要的任何其他范围,然后点击更新。
- 点击保存并继续。
- 如果您不打算立即发布项目,请添加您可能用于测试的每个用户帐号的电子邮件地址,然后点击保存并继续。
- 查看摘要页面,然后点击返回信息中心。
配置现有的 OAuth 同意屏幕
- 打开 “同意屏幕”页面,然后在页面顶部的下拉菜单中选择您的项目。
- 点击修改应用。
- 点击 OAuth 同意屏幕表单上的保存并继续。
- 在下一页上,点击添加或删除脚本。
- 向下滚动,然后在手动添加范围下的字段中输入以下内容:
https://www.googleapis.com/auth/adwords
- 点击添加到表。
- 点击保存并继续。
- 点击测试用户表单上的保存并继续。
- 查看摘要页面,然后点击返回信息中心。
创建客户端 ID 和客户端密钥
如果您使用的是已生成客户端 ID 和密钥的现有 Google API 控制台项目,则可以跳过此步骤。
确定应用类型后,请按照以下说明生成 OAuth 2.0 客户端 ID 和客户端密钥:
打开“凭据”页面。 选择之前创建的项目或创建一个新项目。
在“凭据”屏幕上,点击创建凭据,然后选择 OAuth 客户端 ID。
如果您之前没有为此项目配置 OAuth 同意屏幕,请点击配置同意屏幕。
选择用户类型,然后点击创建。
填写初始表单。如果需要,您以后可以进行修改。完成后,点击保存。
返回到凭据 > 创建凭据 > OAuth 客户端 ID 以继续。
根据您的使用场景,选择桌面应用或 Web 应用作为应用类型。本指南使用桌面应用作为应用类型。
填写应用的名称,然后点击 Create。
在确认页面上,将您的客户端 ID 和客户端密钥复制到剪贴板,以便稍后配置您的客户端库。另外,将 JSON 格式的凭据下载到名为
credentials.json
的文件中。
在项目中启用 Google Ads API
要在您的项目中启用 Google Ads API,请按以下步骤操作:
在 Google API 控制台中打开 API 库。如果系统提示,请选择您的项目或创建一个新项目。API 库中列出了所有可用的 API(按产品系列和热门程度分组)。
如果列表中没有显示 Google Ads API,请使用搜索功能找到该 API。
选择 Google Ads API,然后点击启用按钮。