리소스 이름

Google Ads API의 항목에 대한 고유 식별자를 리소스 이름이라고 하며 예측 가능한 형식이 있는 문자열로 표시됩니다. 엔티티의 구성요소 ID를 알고 있는 경우 Java 클라이언트 라이브러리 유틸리티를 사용하여 전체 리소스 이름을 생성하거나 파싱할 수 있습니다.

ResourceNames로 리소스 이름 구성

ResourceNames 유틸리티 클래스는 항목과 관련된 모든 관련 ID를 알고 있을 때 항목의 리소스 이름을 구성합니다. 예를 들어 캠페인 리소스 이름은 다음 형식입니다.

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)에서 리소스 이름 문자열을 구성 ID로 다시 파싱할 수 있는 강력한 유형의 리소스 이름 클래스 (예: CampaignName, AdGroupName, CustomerName)도 제공합니다.

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

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