云管理的访问权限级别

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

  • 不再需要保护开发者令牌：您可通过 因此您无需再操心 或泄露开发者令牌您可以在 但您仍然需要发送访问令牌。

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

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

前提条件

  • 已获批准的开发者令牌

    要使用此选项，您应该已经拥有已获批准的开发者令牌。您 您可以在 Google Cloud 控制台的 API 中心页面上找到现有的开发者令牌， Google Ads 经理账号。登录， 然后导航至工具与设置 >设置 >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 Workspace 或 Google Cloud Identity客户，很有可能是因为 Google API 控制台项目 因此您可以跳过此步骤。
    您不是 Google Cloud 组织的所有者，无法在 上一步 确保您既是 Google Ads API 管理器的管理员用户 和您的 Google API 控制台项目。您需要有此权限才能 在测试计划申请获批后执行其他步骤。

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

    确保您的 Google Ads API 联系电子邮件地址是最新的。您的 API 联系信息 Google Ads API 经理账号的“API 中心”页面上列有详细信息。 登录，然后导航至工具 和设置 >设置 >API 中心。

注册参与测试计划

注册试行计划。Google 合规团队将 然后审核您的申请， 审批状态和其他详情

如果您请求 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 请求

您可以修改应用，使其在发生以下情况时停止发送 developer-token 标头： 进行 API 调用这是一个可选步骤，但建议您执行此步骤。如果您位于 小规模测试计划，Google Ads API 服务器会忽略 developer-token 作为附件发送 API 请求的特点

Java

即将推出！

.NET

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

接下来，按如下方式修改代码：

// 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/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 Ads API 的 Google 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、请求和响应日志等详细信息，