資源名稱

名稱階層

Google Ads API 中使用的資源名稱具有階層性，可反映 Google Ads 內實體的組織結構。幾乎所有資源都是 Customer 資源的子資源，這反映出幾乎每次 API 呼叫都必須指定 Google Ads 帳戶。舉例來說，廣告活動、廣告群組、廣告和關鍵字都是根層級客戶資源的子資源。

資源 ID

在整個 API 中，Google Ads 實體 (客戶、廣告活動等) 都是以資源名稱表示。不過請注意，資源名稱本身可能會有專屬的數字資源 ID，用於識別階層中的每個物件。在這種情況下，剖析資源名稱以擷取這些資源 ID 並組裝新的資源名稱，或許會有幫助。

舉例來說，請檢查上表中的 AdGroupAd 資源名稱：

customers/1234567890/adGroupAds/54321098765~2109876543210

這可以細分為個別資源 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。

這是相同的基礎轉換動作，但資源名稱與用來存取該動作的帳戶相關。