云端管理的访问权限级别

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

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

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

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

前提条件

  • 已获批的开发者令牌

    您应已拥有获批的开发者令牌，才能使用此选项。您可以在 Google Ads 经理账号的 API 中心内找到现有的开发者令牌。登录，然后依次前往“管理”>“API 中心”。在 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 免费版。然后 创建组织资源。
    上述选项均不适用 在注册参加 Beta 版计划时，请说明您的使用情形，并请求 Google 为您创建组织资源。Google 将免费拥有并管理此组织资源。

  • 为 Beta 版计划准备 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 标头。这是一个可选步骤，但建议您执行此步骤。如果您参与了 Beta 版计划，Google Ads API 服务器会忽略作为 API 请求的一部分发送的 developer-token。

Java

即将推出！

.NET

下载并安装 Google Ads API .NET 库的 17.1.0 版或更高版本。

接下来，按如下所示修改代码：

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

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

// Make the API calls.
...

PHP

即将推出！

Python

即将推出！

Ruby

即将推出！

Perl

即将推出！

HTTP 客户端 (REST)

在 HTTP 请求中省略 developer-token 标头：

curl -i -X POST https://googleads.googleapis.com/v20/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 以及请求和响应日志。