資源名稱是 Google Ads API 中實體的專屬 ID,以可預測格式的字串表示。
使用 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.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;