资源名称

Google Ads API 中实体的唯一标识符称为资源名称，以可预测格式的字符串表示。如果您知道资源名称的组成部分，可以使用 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源文件。