设置 Google API 控制台项目

您需要一个 Google API 控制台项目,才能创建 OAuth 2.0 凭据、配置用户同意屏幕以及为您的应用启用 Google Ads API。

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

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

如果您已有 Google API 控制台项目并希望使用它创建凭据,则可以跳至创建客户端 ID 和客户端密钥

如需创建项目,请按以下步骤操作:

  • 前往 Google API 控制台
  • 点击创建项目
  • 输入名称或接受生成的建议
  • 确认或修改其余所有字段
  • 点击创建

如果已启用结算功能,请为新项目选择结算帐号。Google Ads API 可免费使用,但 Cloud 项目总数有配额限制。

如果您使用的是现有的 Google API 控制台项目,并且之前已配置 OAuth 同意屏幕,则可以跳过此步骤,通过添加 Google Ads API OAuth 2.0 范围来修改同意屏幕。

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

  1. 打开 “同意屏幕”页面,然后在页面顶部的下拉菜单中选择您的项目。
  2. 选择用户类型,然后点击创建
  3. 填写同意屏幕表单。如果需要,您以后可以对此进行修改。 完成后,点击保存并继续
  4. 在下一页上,点击添加或移除范围
  5. 向下滚动,然后在手动添加范围下的字段中输入以下内容:

    https://www.googleapis.com/auth/adwords

  6. 点击添加到表格
  7. 添加您的项目可能需要的任何其他范围,然后点击更新
  8. 点击保存并继续
  9. 如果您不打算立即发布项目,请添加您可能用于测试的每个用户帐号的电子邮件地址,然后点击保存并继续
  10. 查看摘要页面,然后点击返回信息中心
  1. 打开 “同意屏幕”页面,然后在页面顶部的下拉菜单中选择您的项目。
  2. 点击修改应用
  3. 点击 OAuth 同意屏幕表单上的保存并继续
  4. 在下一页上,点击添加或移除范围
  5. 向下滚动,然后在手动添加范围下的字段中输入以下内容:

    https://www.googleapis.com/auth/adwords

  6. 点击添加到表格
  7. 点击保存并继续
  8. 点击测试用户表单上的保存并继续
  9. 查看摘要页面,然后点击返回信息中心

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

如果您使用的是已生成客户端 ID 和密钥的现有 Google API 控制台项目,则可以跳过此步骤。

确定应用类型后,请按照以下说明生成 OAuth 2.0 客户端 ID 和客户端密钥:

  1. 打开“凭据”页面。 选择之前创建的项目或创建新项目。

  2. 在“凭据”屏幕上,点击创建凭据,然后选择 OAuth 客户端 ID

    • 如果您之前没有为此项目配置 OAuth 同意屏幕,请点击配置同意屏幕

      • 选择用户类型,然后点击创建

      • 填写初始表单。如有需要,您以后还可修改此字段。完成后,点击保存

    • 导航回凭据 > 创建凭据 > OAuth 客户端 ID 以继续操作。

  3. 选择桌面应用 Web 应用作为应用类型,具体取决于您的用例。本指南使用桌面应用作为应用类型。

  4. 填写应用的名称,然后点击创建

  5. 在确认页面上,将您的客户端 ID您的客户端密钥复制到剪贴板,以便稍后配置客户端库。此外,将 JSON 格式的凭据下载到名为 credentials.json 的文件中。

在项目中启用 Google Ads API

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

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

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

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