Google Ads API 中的账号类型

本文档介绍了 Google Ads API 中用于描述账号的不同术语,以及它们之间的关系。

概览

Google Ads API 使用多个术语来描述账号,这有时可能会导致混淆。了解这些区别对于管理账号和解读 API 响应非常重要。

账号类型

以下定义阐明了您在使用 Google Ads API 时会遇到的不同账号类型。

经理账号

经理账号是用于管理多个 Google Ads 账号的主账号。

  • 曾用名:以前称为“MCC”(我的客户中心)。您可能仍会在旧版文档或讨论中看到此术语。
  • 用途:如果您想通过单一层级结构关联和管理多个账号,请使用经理账号。
  • API 表示法:由 Customer 资源标识,其中 customer.manager 为 true。

广告客户(投放)账号

广告客户账号(或广告投放账号)是投放广告系列的单个 Google Ads 账号。

  • 用途:这是制作和投放广告系列、广告组、素材资源组和广告的地方。
  • API 表示法:由 Customer 资源标识,其中 customer.manager 为 false。

客户账号

客户账号是指与层级结构中的上级经理账号相关联并由其管理的任何账号(广告客户账号或其他经理账号)。

  • 背景信息:“客户”一词是指层次结构中的关系(由经理账号管理),不一定是业务意义上的“客户”。
  • API 表示法:查询 CustomerClient 以检查经理账号层次结构中的账号,并使用 CustomerClientLink 管理经理账号与客户账号之间的关联。

客户

在 API 上下文中,Customer 是表示任何 Google Ads 账号(无论是经理账号还是广告客户账号)的资源。

  • 表示形式:所有账号均由 Customer 资源表示,并由 customer_id 标识。
  • 角色:账号的性质(经理或投放)取决于具体资源。

测试账号

测试账号是专门用于测试 API 集成的特殊广告客户账号,这些账号在专用的测试经理账号下进行管理。测试经理账号及其下属的测试广告客户账号的 customer.test_account 字段均设置为 true。无法在生产经理账号下创建测试账号。

  • 用途:借助测试账号,您可以测试 API 调用,而无需投放实际广告或产生费用。此类订单项不会投放实际广告。
  • API 表示法:由 Customer 资源标识,其中 customer.test_account 为 true(customer.manager 用于区分测试经理账号和测试广告客户账号)。

层次结构示例

典型的层次结构如下所示:

  • 经理账号 A(顶级)
    • 客户账号 B(广告客户账号)
    • 客户账号 C(另一个经理账号)
      • 客户账号 D(广告客户账号)

在此示例中:

  • 账号 A 是经理账号。
  • 账号 B、C 和 D 是其父级账号的客户账号。
  • 账号 B 和 D 是广告客户(投放)账号。
  • 账号 C 既是客户账号(对 A 而言),也是经理账号(对 D 而言)。