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 上下文中,客户 是指代表任何 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)。