資源名稱

名稱階層

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

重點： Google Ads API 使用 相對資源名稱 (而非完整資源名稱 例如其他 Google API)。

資源 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)。

重點： JSON 要求和回應主體中的資源名稱 resourceName 欄位，而不是 name 和某些 Google Cloud API 一樣許多 Google Ads 實體都使用了 屬性本身 (campaign.Name、adGroup.Name 等)，因此 resourceName 來避免與現有物件名稱衝突。

共用物件的 ID

API 中的大多數物件都與特定 Google Ads 相關聯 用來追蹤協助客戶的客服專員姓名不過，有些物件類型可以在 多個帳戶。實務上，就像是排除關鍵字 名單或跨帳戶 轉換動作 通常由管理員建立，然後與多個客戶帳戶共用。

這類物件的資源名稱會有所不同，具體取決於 所要傳送 API 呼叫的目的地帳戶。

範例：跨帳戶轉換動作

假設我們有管理員帳戶 (987-654-3210) 共用一個跨帳戶 轉換動作 (包含其中一個客戶帳戶的轉換動作)：123-456-7890

向管理員帳戶發出 API 呼叫，例如將轉換更新 動作的回溯期會以資源名稱參照共用物件： customers/9876543210/conversionActions/257733534。

向客戶帳戶發出 API 呼叫，以加入使用共用 轉換動作會使用資源名稱進行參照： customers/1234567890/conversionActions/257733534。

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