- Google Ads API - 概览
- Google Ads API - 获取开发者令牌
- Google Ads API - 设置 Google API 控制台项目
- Google Ads API - 准备 Google Ads 帐号
- Google Ads API - 准备支持工具
- Google Ads API - 使用 Google OAuth 2.0 生成令牌
- Google Ads API - 调用 REST API
您需要有一个 Google API 控制台项目,才能为应用创建 OAuth 2.0 凭据、配置用户同意屏幕以及启用 Google Ads API。
Google 服务器对 Google Ads 用户进行身份验证和授权时需要用到这些凭据。通过这些凭据,您可以生成 OAuth 令牌,以便在调用 API 时使用。
创建 Google API 控制台项目
-
点击创建项目。
-
输入名称或接受生成的建议
-
确认或修改其余所有字段
-
点击创建
配置 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 权限请求页面,请点击 CONFIGURE CONSENT SCREEN(配置同意屏幕)。
- 选择用户类型,然后点击创建。
- 填写初始表单。如果需要,您后续可以对此进行修改。完成后,点击保存。
- 返回凭据 > 创建凭据 > OAuth 客户端 ID 以继续操作。
-
选择桌面应用或 Web 应用作为应用类型,具体取决于您的使用场景。
-
填写应用名称,然后点击创建。
-
在确认页面上,将您的客户端 ID 和您的客户端密钥复制到剪贴板,以便稍后使用。此外,请将 JSON 格式的凭据下载到名为
credentials.json的文件中。
在项目中启用 Google Ads API
要在您的项目中启用 Google Ads API,请按以下步骤操作:
- 在 Google API 控制台中打开 API 库。API 库中列出了所有可用的 API(按产品系列和热门程度分组),请先选择一个项目或创建一个新的项目。
- 如果列表中没有显示 Google Ads API,请使用搜索功能找到该 API。
- 选择 Google Ads API,然后点击启用按钮。