资源名称

Google Ads API 中实体的唯一标识符称为资源名称，以可预测格式的字符串表示。如果您知道资源名称的组成部分，可以使用 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)