为 Google Ads API 配置 Google API 控制台项目

要对 Google Ads 用户进行身份验证和授权，您就必须提供用于访问 Google OAuth2 服务器的凭据。这些凭据会让 Google 识别您的应用，并允许您生成用于管理 Google Ads 用户的 OAuth 令牌。通过 Google API 控制台，您可以对 Google OAuth2 凭据的访问权限进行管理。

观看此视频，了解一些 Cloud 项目最佳实践

Google OAuth 验证

用于获取 Google Ads API 范围凭据的任何 Google Cloud 应用都需要接受 Google OAuth 验证，以免向用户显示未经验证的界面屏幕。在本上下文中，应用是指 Google Cloud 中唯一的 OAuth 2.0 客户端 ID。

除开发者令牌审批流程中执行的所有审核外，您还需独立执行此验证。由于 Google Ads API 权限范围属于敏感权限范围，因此此验证是必需的。

Google 验证无需付费，通常会在 3 至 5 个工作日内完成。此政策适用于所有应用。

我们建议所有应用尽快完成 Google OAuth 验证流程，以免业务中断。

创建项目

前往 Google API 控制台。点击创建项目，输入名称，然后点击创建。

要点 ：如果您已启用（例如 Google Cloud 上的）结算功能，则必须为新项目选择一个结算账号。

使用 Google Ads API 无需支付任何费用，不过，会对 Google Cloud 项目的总数有配额限制。或者，您可以注册一个包含免费项目配额的新 Google 账号。

在项目中启用 Google Ads API

如需为您的项目启用 Google Ads API，请按照以下步骤操作：

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

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

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

选择用户类型和发布状态

启用该 API 后，您必须指定项目的用户类型和发布状态。下表突出显示了这些设置的每种组合的某些关键属性和限制。如需了解详情，请参阅 Google Cloud Platform 文档。

用户类型	发布状态	限制
内部	测试	仅适用于与 Google Cloud 组织关联的项目。 最多只能有 OAuth 同意屏幕中列出的 100 名测试用户。 测试用户必须是与项目关联的 Google Cloud 组织中的内部用户。 授权将在用户同意之日起 7 天后过期。
外部	测试	适用于所有项目。 最多只能有 OAuth 同意屏幕中列出的 100 位测试用户。 测试用户可以是任何拥有 Google 账号的用户。 授权将在用户同意之日起 7 天后过期。
内部	正式版	仅适用于与 Google Cloud 组织关联的项目。 允许授权与项目关联的 Google Cloud 组织中的任何用户。
外部	正式版	适用于所有项目。 允许授权拥有 Google 账号的任何用户。

无论您的项目的用户类型或发布状态如何，如果未完成 Google OAuth 验证，都会导致以下结果：

• 在授权流程中，系统会向用户显示表明界面未经验证的屏幕。

• 您只能授权 100 位用户。

配置 OAuth 权限请求页面

1. 打开“意见征求界面”页面，然后在页面顶部的下拉菜单中选择您的项目。

2. 选择用户类型，然后点击创建。

3. 填写意见征求界面表单。日后若有需要，您可以修改。完成后，点击保存并继续。

4. 在下一页上，点击添加或移除镜重。

   • 向下滚动，然后在 Manually add scopes 下方的字段中输入以下内容：

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

   • 点击添加到表格。

   • 添加您的项目将请求的任何其他镜重，然后点击更新。

   • 点击保存并继续。

5. 如果您不打算立即发布项目，请添加您要用于测试的每个用户账号的电子邮件地址，然后点击保存并继续。

6. 查看摘要页面，然后点击返回信息中心。

测试完应用和授权流程后，您可以返回信息中心，然后点击发布应用，将其发布状态从测试更改为正式版。

选择应用类型

Google Ads API 有两种应用类型选项：桌面版或网站。请参阅下表，确定哪种类型最适合您要构建的应用：

选择此应用类型	如果...
桌面应用	您正在使用一个顶级经理账号管理所有 Google Ads 账号。 您是首次使用的用户，或者想要使用最简单的设置快速上手。 您的应用将仅针对一台机器上的 Google 用户进行身份验证。
Web 应用	您想以能够授权您的应用访问其 Google Ads 账号数据的用户身份进行身份验证。 您希望轻松生成多个授权凭据，以便管理（比如）第三方账号。 您的应用需要回调网址。桌面应用流程不支持回调网址。

要点 ：即使您正在开发要在服务器上运行的应用，仍然可以选择桌面应用流程。区别在于 OAuth 授权是在本地还是远程完成的。桌面流程要求在本地机器上完成授权，而网页流程允许在 Google 的授权服务器上完成授权。

如需了解详情，请参阅有关桌面应用或网络应用的 Google 身份平台 OAuth 文档。

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

确定应用类型后，请按照以下说明生成 OAuth2 客户端 ID 和客户端密钥：

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

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

   1. 如果您先前未曾为此项目配置过 OAuth 同意屏幕，系统会引导您立即执行此操作。点击配置权限请求页面。

      1. 选择用户类型，然后点击创建。

      2. 填写初始表单。日后若有需要，您可以修改。完成后，点击保存。

   2. 返回到凭据 > 创建凭据 > OAuth 客户端 ID 以继续操作。

3. 根据您的使用情形，选择桌面应用或网络应用作为应用类型。

4. 为其命名，然后点击创建。

5. 如果您的客户端类型为Web 应用，请添加至少一个已获授权的重定向 URI。

   对于与客户端库示例中的默认配置兼容的本地测试，请使用 http://127.0.0.1。

   注意 ：您可以向重定向 URI 添加端口号，以将使用限制为特定端口。如果未设置端口，OAuth 客户端可以重定向到任何端口。

   对于桌面应用客户端，您仍然需要使用环回 IP 重定向，但 URI 不会在 Cloud 控制台中明确配置。

6. 在确认页面上，将您的客户端 ID 和您的客户端密钥复制到您的剪贴板，您在配置客户端库时需要用到这些信息。您也可以稍后返回到“凭据”页面来检索这些详细信息。