Google Ads API 中實體的專屬 ID 稱為「資源名稱」,以可預測格式的字串表示。如果您知道資源名稱的組成元件,可以使用 PathLookupUtil 生成最終資源名稱。
PathLookupUtil
當您提供與實體相關的所有 ID 時,PathLookupUtil 公用程式會建構實體的資源名稱。舉例來說,廣告活動資源名稱的格式為 customers/{customer_id}/campaigns/{campaign_id},因此如果您知道客戶 ID 和廣告活動 ID,可以使用 client.path 建構完整資源名稱:
require 'google/ads/google_ads'
client = Google::Ads::GoogleAds::GoogleAdsClient.new
customer_id = '1234567890'
campaign_id = '9876543210'
# Generates: "customers/1234567890/campaigns/9876543210"
campaign_resource_name = client.path.campaign(customer_id, campaign_id)
支援的實體
您也可以在 client.path 上使用其他實體名稱,根據資源名稱的階層接受不同的 ID:
- 廣告活動:
client.path.campaign(customer_id, campaign_id) - 廣告群組:
client.path.ad_group(customer_id, ad_group_id) - 廣告群組廣告:
client.path.ad_group_ad(customer_id, ad_group_id, ad_id)