リソース名

Google Ads API のエンティティの一意の識別子はリソース名と呼ばれ、予測可能な形式の文字列として表されます。リソース名の構成要素がわかっている場合は、ResourceNames ユーティリティを使用して、フォーマットされたリソース名を生成できます。

ResourceNames クラス

ResourceNames ユーティリティは、エンティティに関連するすべての関連 ID がわかっている場合に、エンティティのリソース名を構築します。ID は、ハイフンを含まない数字のみの文字列として渡します。

たとえば、キャンペーンのリソース名は customers/{customer_id}/campaigns/{campaign_id} の形式です。顧客 ID とキャンペーン ID がわかっている場合は、ResourceNames ユーティリティを使用して、次のように完全なリソース名を構築できます。

use Google::Ads::GoogleAds::V25::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V25::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

ResourceNames ユーティリティは、ad_group()、customer()、ad_group_criterion() などの他のエンティティ タイプにも同様のヘルパー メソッドを提供します。ResourceNames は、サポートされている各 API バージョンの名前空間（V25 など。v25.1 などのマイナー API リリースでは、メジャー バージョン モジュール V25 が使用されます）にスコープ設定されているため、以前のバージョンを使用している場合は、V25 をターゲット API バージョンに置き換えてください。サポートされているヘルパー メソッドの完全なリストについては、ResourceNames.pm ソースファイルをご覧ください。