云管理的访问权限级别

借助此功能，您的 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/v16/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 以及请求和响应日志等详细信息。