資源名稱

名稱階層

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

Google Ads 實體 (客戶、廣告活動等) 稱為客戶資源 整個 API 中的名稱但請務必注意 而且名稱本身可能有專屬的數值資源 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。

這與基礎轉換動作相同，但資源名稱是相對的 登入用於存取系統的帳戶