資源名稱

Google Ads API 中實體的專屬 ID 稱為「資源名稱」，以可預測格式的字串表示。如果您知道資源名稱的組成元件，可以使用 ResourceNames 公用程式產生格式化資源名稱。

ResourceNames 類別

當您知道與實體相關的所有 ID 時，ResourceNames 公用程式會建構實體的資源名稱。請以字串形式傳遞 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 來源檔案。