云端管理的访问权限级别

借助此功能,您可以让 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 WorkspaceGoogle Cloud Identity 客户 您很可能已拥有组织资源。您可以 检查根据需要 创建一个
    您未使用 Google WorkspaceGoogle Cloud Identity 注册 Google Cloud Identity 免费版。然后 创建组织资源
    上述选项均不适合您 注册参加小规模测试时,请说明您的场景,并请求 Google 为您创建组织资源。Google 将免费拥有和管理此组织资源。
  • 为小规模测试计划准备 Google API 控制台项目

    您需要为小规模测试计划准备与 Google Ads API 搭配使用的 Google API 控制台项目,具体如下:

    场景 步骤
    您已拥有 Google Cloud 组织或在 上一步中创建了一个 确保您已启用 Google Ads API 的所有 Google API 控制台项目都位于此组织下。如果不是,请将其迁移 到该组织下

    如果您是现有 Google WorkspaceGoogle 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 服务器会忽略作为 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/v24/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"

常见问题解答

以下是关于 Cloud 管理的访问权限级别的一些常见问题解答。

此项变更是否意味着我需要成为 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、请求和响应日志等详细信息。