리소스 이름

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

ResourceNames 클래스

ResourceNames 유틸리티는 항목과 관련된 모든 관련 ID를 알고 있는 경우 항목의 리소스 이름을 구성합니다. ID를 하이픈 없이 숫자만 포함하는 문자열로 전달합니다.

예를 들어 캠페인 리소스 이름은 customers/{customer_id}/campaigns/{campaign_id} 형식입니다. 고객 ID와 캠페인 ID를 알고 있는 경우 ResourceNames 유틸리티를 사용하여 다음과 같이 전체 리소스 이름을 구성할 수 있습니다.

use Google::Ads::GoogleAds::V26::Utils::ResourceNames;

my $customer_id = "1234567890";
my $campaign_id = "9876543210";

# Generates: "customers/1234567890/campaigns/9876543210"
my $resource_name =
  Google::Ads::GoogleAds::V26::Utils::ResourceNames::campaign(
    $customer_id,
    $campaign_id
  );

ResourceNames 유틸리티는 ad_group(), customer(), ad_group_criterion()와 같은 다른 항목 유형에 유사한 도우미 메서드를 제공합니다. ResourceNames는 지원되는 각 API 버전 네임스페이스(예: v26.1와 같은 마이너 API 출시 버전이 메이저 버전 모듈 V26을 사용하는 V26)로 범위가 지정되므로 이전 버전을 사용하는 경우 V26을 타겟 API 버전으로 바꿉니다. 지원되는 도우미 메서드의 전체 목록은 ResourceNames.pm 소스 파일을 참조하세요.