资源名称是 Google Ads API 中实体的唯一标识符,以可预测格式的字符串表示。
使用 ResourceNames 构建资源名称
ResourceNames 是一个实用程序类,如果您知道与实体相关的所有相关 ID,则可以使用该类来构建实体的资源名称。例如,广告系列资源名称采用 customers/{customer_id}/campaigns/{campaign_id} 格式。如果您知道客户 ID 和广告系列 ID,可以使用 ResourceNames 类来构建完整的资源名称,如下所示:
long customerId = 1234567890L;
long campaignId = 9876543210L;
string campaignResourceName = ResourceNames.Campaign(customerId, campaignId);
您还可以通过使用必需的 ID 调用 ResourceNames 上的相应方法,为其他实体构建资源名称。
解析资源名称
.NET 客户端库还提供强类型资源名称类(例如 Google.Ads.GoogleAds.V25.Resources 命名空间中的 CampaignName、AdGroupName 和 CustomerName),可让您将资源名称字符串解析回其各个 ID 组件:
using Google.Ads.GoogleAds.V25.Resources;
CampaignName campaignName = CampaignName.Parse(campaignResourceName);
string parsedCustomerId = campaignName.CustomerId;
string parsedCampaignId = campaignName.CampaignId;