注意:您正在查看 API 的 REST 介面說明文件。我們的官方用戶端程式庫支援 gRPC。詳情請參閱 REST 簡介

資源名稱

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

名稱階層

Google Ads API 中使用的資源名稱是階層式的,代表 Google Ads 中的實體機構。幾乎所有資源都是 Customer 資源的子資源,反映出幾乎所有 API 呼叫都必須指定特定 Google Ads 帳戶。舉例來說,廣告活動、廣告群組、廣告和關鍵字都是根客戶資源的子資源。

資源 資源名稱
客戶 customers/1234567890
廣告活動 customers/1234567890/campaigns/8765432109
廣告群組 customers/1234567890/adGroups/54321098765
groupAd customers/1234567890/adGroupAds/54321098765~2109876543210

資源 ID

Google API 實體 (客戶、廣告活動等) 會在 API 中參照資源名稱。但請注意,資源名稱本身可能會有專屬的數值資源 ID,以識別階層中的每個物件。在這些情況下,剖析資源名稱以擷取這些資源 ID 並組合新的 ID。

例如,您可以查看上表的 AdGroupAd 資源名稱:

customers/1234567890/adGroupAds/54321098765~2109876543210

可細分為個別的資源 ID (以集合 ID 分隔),如下所示:

資源名稱元件
資源 ID
客戶 ID:
"1234567890"
廣告群組 ID:
"54321098765"
廣告群組廣告 ID:
"2109876543210"
集合 ID
"customers"
"adGroupAds"

剖析個別 ID 可讓您取得新的資源名稱,以參照廣告群組廣告的客戶 (customers/1234567890) 或其廣告群組 (customers/1234567890/adGroupAds/54321098765)。

共用物件的 ID

API 中的大多數物件都與單一特定 Google Ads 客戶相關聯。然而,有些物件可在多個帳戶之間共用。實際上,這些是排除關鍵字清單跨帳戶轉換動作等,通常由管理員建立,然後分享給許多客戶帳戶。

視您要傳送 API 呼叫的帳戶而定,這類物件的資源名稱會有所不同。

範例:跨帳戶轉換動作

假設管理員帳戶 987-654-3210 與其其中一個客戶帳戶 123-456-7890 共用跨帳戶轉換動作:

這張圖表顯示資源名稱與帳戶階層之間的關係。

舉例來說,如果對管理員帳戶發出 API 呼叫,藉此更新轉換動作,請在回溯期內使用資源名稱參照共用物件:customers/9876543210/conversionActions/257733534

客戶帳戶發出 API 呼叫來選擇使用共用轉換動作時,系統會使用資源名稱來參照該名稱:customers/1234567890/conversionActions/257733534

這與基礎轉換動作相同,但其資源名稱相對於存取它的帳戶。