資源名稱

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

ResourceNames 類別

如果您知道實體的所有相關 ID，ResourceNames 公用程式會建構實體的資源名稱。傳遞 ID 時，請使用僅含數字的字串，不要包含連字號。

舉例來說，廣告活動資源名稱的格式為 customers/{customer_id}/campaigns/{campaign_id}。如果您知道客戶 ID 和廣告活動 ID，可以使用 ResourceNames 公用程式建構完整的資源名稱，如下所示：

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

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

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

ResourceNames 公用程式為其他實體類型 (例如 ad_group()、customer() 和 ad_group_criterion()) 提供類似的輔助方法。請注意，ResourceNames 的範圍限定在每個支援的 API 版本命名空間 (例如 V26，其中 v25.1 等次要 API 版本會使用其主要版本模組 V25)，因此如果您使用的是舊版，請將 V26 替換為目標 API 版本。如需支援的輔助方法完整清單，請參閱 ResourceNames.pm 來源檔案。