資源名稱

名稱階層

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

在整個 API 中，Search Ads 360 Reporting API 實體 (客戶、廣告活動等) 都是以資源名稱參照。不過請注意，資源名稱本身可能具有專屬的數字資源 ID，可識別階層中的每個物件。在這種情況下，剖析資源名稱以擷取這些資源 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)。