這份文件說明 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)。