云管理的访问权限级别

借助此功能，您的 API 访问权限级别可由 Google Cloud 组织管理，从而为您带来以下优势：

• 不再需要保护开发者令牌：API 访问权限将通过 Google Cloud 组织进行管理，因此您无需再担心开发者令牌的安全或泄露。您可以在 API 调用中跳过发送开发者令牌，但仍需要发送访问令牌。

• 为不同的应用分别维护单独的 Google API 控制台项目：Google Cloud 组织下关联的任何项目都会继承该组织的 API 访问权限级别。这样，您就可以在此组织下创建多个 Google API 控制台项目，以便进行精细的项目管理、为不同应用创建单独的项目，以及为团队成员使用多个 Google API 控制台项目。

• 更精细的配额监控和管理：您可以监控单个项目的 API 用量或设置 API 用量上限。

前提条件

• 已获批准的开发者令牌

  要使用此选项，您应该已经拥有已获批准的开发者令牌。您可以在 Google Ads 经理帐号的 API 中心页面上找到现有的开发者令牌。登录，然后依次转到工具与设置 > 设置 > API 中心。

• Google Cloud 组织

  Google Ads API 会将您的开发者令牌与 Google Cloud 组织相关联，并使用该令牌来确定您的 API 访问权限级别。您可以通过多种方式创建 Google Cloud 组织。

  场景	步骤
  您已经是 Google Workspace 或 Google Cloud Identity 客户	您可能已经拥有组织资源。如果需要，您可以检查并创建一个。
  您没有使用 Google Workspace 或 Google Cloud Identity	注册免费版的 Google Cloud Identity。然后 创建组织资源。
  上述选项都不适合您	请说明您注册参与测试并请求 Google 为您创建组织资源时的场景。Google 将免费拥有和管理此组织资源。

• 针对试行计划准备您的 Google API 控制台项目

  对于此测试计划，您需要按照以下要求准备通过 Google Ads API 使用的 Google API 控制台项目：

  场景	步骤
  您已拥有 Google Cloud 组织或在上一步中创建了一个组织	确保您启用了 Google Ads API 的所有 Google API 控制台项目都位于此组织下。如果没有，请将其迁移到组织下。 如果您已经是 Google Workspace 或 Google Cloud Identity 客户，那么您的组织可能已有 Google API 控制台项目，因此您可以跳过此步骤。
  您没有 Google Cloud 组织，无法在上一步中创建组织	确保您既是 Google Ads API 经理帐号的管理员用户，也是 Google API 控制台项目的管理员用户。在测试计划申请获批后，您需要此权限才能执行其他步骤。

• 最新的 API 联系人电子邮件地址

  确保您的 Google Ads API 联系电子邮件地址是最新的。您的 API 详细联系信息列在 Google Ads API 经理帐号的“API 中心”页面上。登录，然后依次转到工具与设置 > 设置 > API 中心。

注册参与测试计划

注册试行计划。然后，Google 合规性团队将审核您的申请，并向您的 API 联系人电子邮件地址发送电子邮件，附上审批状态和其他详细信息。

如果您请求 Google 为您创建 Google Cloud 组织，则还需要执行几个额外的步骤：

1. Google 将为您创建 Google 自有的 Cloud 组织资源。您的 Google Ads API 经理帐号的所有管理员将被授予新创建的组织的 roles/resourcemanager.projectCreator 角色。

2. Google 将向您的 API 联系人电子邮件地址发送电子邮件，提供新创建的组织资源的详细信息。

3. 您需要登录您的 Google API 控制台帐号，然后按照说明将您的 Google API 控制台项目转移到新组织下。

4. 回复此电子邮件，告知 Google 您的项目已移至新组织下。

5. Google 合规性团队将审核您的申请，并向您的 API 联系人电子邮件地址发送电子邮件，附上审批状态和其他详细信息。

修改 API 请求

您可以修改应用，使其在进行 API 调用时停止发送 developer-token 标头。这是一个可选步骤，但建议您执行此步骤。如果您加入了试行计划，Google Ads API 服务器会忽略 developer-token 作为 API 请求的一部分发送。

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

curl -i -X POST https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

常见问题解答

此项变更是否意味着我需要成为 Google Workspace 或 Google Cloud 客户才能使用 Google Ads API？

不会。您需要一个可通过多种方式获取的 Google Cloud 组织。此要求类似于您目前需要 Google API 控制台项目才能使用 Google Ads API。

我需要更改 API 访问权限级别。如何才能做到这一点？

您目前应继续使用 API 中心来请求对 API 访问权限级别进行任何更改。

选择加入此测试是否有休息时间？

没有。一旦获得批准，Google Ads API 将自动开始使用组织级 API 访问权限级别。

需要投入多少精力才能参与此试行计划？

预计只需极少的代码更改。大多数开发者应该能够在 30 分钟内完成对其应用的更改。

如果我选择加入此试行计划，是否需要支付费用？

一般来说，如果您选择参加此试行计划，我们不会向您收费。Google Ads API 是免��提供的，Google 不会对 Google Ads API 的定价模式做出任何更改。

获取 Google Cloud 组织的可能场景如下：

1. 您已经是 Google Workspace 或 Google Cloud Identity 客户：

   您将照常为这些商品的使用付费。为参与此试行计划而创建 Google Cloud 组织无需付费。

2. 您已创建 Google Cloud Identity 免费版帐号：

   注册 Google Cloud Identity 免费版帐号或为参与此试行计划而创建 Google Cloud 组织时，我们不会向您收取费用。

3. Google 为您创建了 Cloud 组织资源：

   这是 Google 管理的内部 Cloud 组织资源，因此您无需付费。

我有多个针对不同工具的开发者令牌。此测试对我有何影响？

此用例不受支持，因此您无法参与此测试。

这是否会影响我使用 Google Ads API 管理的帐号的现有 API 授权？

不会，这项变更不会影响您使用 Google Ads API 管理的 Google Ads 帐号的任何现有 API 授权。

我选择加入此试行计划，并遇到了问题或提供反馈。如何联系支持团队？

使用 API 技术支持页面与 Google Ads API 团队联系，并说明问题的性质。请尽可能提供组织 ID 等详细信息以及请求和响应日志。