云管理的访问权限级别

借助此功能，您可以让 Google Cloud 组织管理 API 访问权限级别，从而获享以下优势：

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

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

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

前提条件

• 已获批准的开发者令牌

  您应该已经拥有已获批准的开发者令牌，才能使用此选项。您可以在 Google Ads 经理账号的 API 中心内找到现有开发者令牌。登录，然后依次前往“管理”>“API 中心”。在 API Center 中，依次前往“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 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 标头。这是一个可选步骤，但建议您执行此步骤。如果您参与了该试行计划，那么如果 developer-token 是作为 API 请求的一部分发送的，Google Ads API 服务器会忽略该 developer-token。

// 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/v18/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 Center 来请求更改 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 和请求和响应日志等详细信息。