リソース名は、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.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;