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)。