리소스 이름

Google Ads API의 항목에 대한 고유 식별자를 리소스 이름이라고 하며, 예측 가능한 형식의 문자열로 표시됩니다. 리소스 이름의 구성요소를 알고 있는 경우 ResourceNames 유틸리티를 사용하여 형식이 지정된 리소스 이름을 생성할 수 있습니다.

ResourceNames 클래스

ResourceNames 유틸리티는 항목과 관련된 모든 ID를 알고 있을 때 항목의 리소스 이름을 구성합니다. 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 소스 파일을 참고하세요.