資源名稱

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)