リソース名

Google Ads API のエンティティの一意の識別子はリソース名と呼ばれ、予測可能な形式の文字列として表されます。エンティティの構成要素 ID がわかっている場合は、Java クライアント ライブラリ ユーティリティを使用して完全なリソース名を生成または解析できます。

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（com.google.ads.googleads.lib.utils.ResourceNames）は、サポートされているすべての API バージョンでバージョンに依存しませんが、Java クライアント ライブラリは、各バージョン付きリソース パッケージ（com.google.ads.googleads.v25.resources など）で、リソース名文字列を構成 ID に解析できる厳密に型指定されたリソース名クラス（CampaignName、AdGroupName、CustomerName など）も提供します。

import com.google.ads.googleads.v25.resources.CampaignName;

CampaignName campaignName = CampaignName.parse(campaignResourceName);
String parsedCustomerId = campaignName.getCustomerId();
String parsedCampaignId = campaignName.getCampaignId();