资源名称

Google Ads API 中实体的唯一标识符称为资源名称，以可预测格式的字符串表示。如果您知道实体的组成 ID，则可以使用 Java 客户端库实用程序生成或解析完整资源名称。

使用 ResourceNames 构建资源名称

当您知道与实体相关的所有相关 ID 时，ResourceNames 实用程序类会构建实体的资源名称。例如，广告系列资源名称采用以下格式：

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）中提供了强类型资源名称类（例如 CampaignName、AdGroupName 和 CustomerName），让您可以将资源名称字符串解析回其组成 ID：

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

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