리소스 이름

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

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

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