資源名稱

名稱階層

Search Ads 360 Reporting API 中使用的資源名稱是階層式資源, 在 Search Ads 360 中的實體整理。幾乎所有資源都是子資源 Customer 這樣就能因應幾乎所有 API 呼叫都必須指定 特定 Search Ads 360 帳戶的資料例如「廣告活動」、「廣告群組」、「廣告」和「關鍵字」。 都是根客戶資源的所有子資源

資源 資源名稱
客戶 customers/1234567890
廣告活動 customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

資源 ID

Search Ads 360 Reporting API 實體 (客戶、廣告活動等) 是透過其資源所參照 整個 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).