命名階層
Google Ads API 中使用的資源名稱是階層式的,與 Google Ads 中的實體組織相對應。幾乎所有資源都是 Customer
資源的子資源,這表示幾乎每個 API 呼叫都必須指定特定 Google Ads 帳戶。例如廣告活動、廣告群組、廣告和關鍵字都是根客戶資源的所有子資源。
資源 | 資源名稱 |
---|---|
客戶 | customers/1234567890
|
廣告活動 | customers/1234567890/campaigns/8765432109
|
AdGroup | customers/1234567890/adGroups/54321098765
|
AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
資源 ID
在 API 中,Google Ads 實體 (客戶、廣告活動等) 都以其資源名稱來指稱。不過,請務必注意,資源名稱本身可以有專屬的數值資源 ID,用來識別階層中的每個物件。在這類情況下,建議您剖析資源名稱,以擷取這些資源 ID 並組合新 ID。
例如,檢查上一個資料表的 AdGroupAd
資源名稱:
customers/1234567890/adGroupAds/54321098765~2109876543210
此資料可細分為個別資源 ID (以集合 ID 分隔),如下所示:
資源名稱元件 | |||||||
---|---|---|---|---|---|---|---|
資源 ID |
|
||||||
集合 ID |
|
剖析個別 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
。
這是相同的基礎轉換動作,但其資源名稱與用來存取動作的帳戶相關。