資源名稱

Google Ads API 中實體的專屬 ID 稱為「資源名稱」，以可預測格式的字串表示。如果您知道實體的組成 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();