资源名称是 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);
您也可以通过在 ResourceNames 上调用相应的方法并提供所需的 ID,为其他实体构建资源名称。
解析资源名称
.NET 客户端库还提供了强类型资源名称类(例如 Google.Ads.GoogleAds.V26.Resources 命名空间中的 CampaignName、AdGroupName 和 CustomerName),可让您将资源名称字符串解析回其各个 ID 组件:
using Google.Ads.GoogleAds.V26.Resources;
CampaignName campaignName = CampaignName.Parse(campaignResourceName);
string parsedCustomerId = campaignName.CustomerId;
string parsedCampaignId = campaignName.CampaignId;