資源名稱

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)

注意： 顧客 ID 和實體 ID 可以整數或不含連字號的字串形式傳遞 (例如 '1234567890'，而非 '123-456-7890')。

支援的實體

您也可以在 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)