名稱階層
Google Ads API 中使用的資源名稱是階層式的，代表 Google Ads 中的實體架構。幾乎所有資源都是 Customer 資源的子資源，反映出幾乎所有 API 呼叫都必須指定特定的 Google Ads 帳戶。舉例來說，廣告活動、廣告群組、廣告和關鍵字都是根客戶資源的所有子資源。
| 資源 | 資源名稱 |
|---|---|
| 客戶 | customers/1234567890
|
| 廣告活動 | customers/1234567890/campaigns/8765432109
|
| 廣告群組 | customers/1234567890/adGroups/54321098765
|
| 廣告群組廣告 | customers/1234567890/adGroupAds/54321098765~2109876543210
|
資源 ID
Google Ads 實體 (客戶、廣告活動等) 在 API 中都會參照其資源名稱。但請注意，資源名稱本身可能會有專屬的數字資源 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。
這與基礎轉換動作相同，但其資源名稱相對於存取它的帳戶。