Perl 클라이언트 라이브러리

Perl 클라이언트 라이브러리는 GitHub에서 호스팅되며 패키지는 CPAN에서 사용할 수 있습니다.

이 라이브러리는 Perl 버전 5.28.1 이상을 지원합니다.

REST API 프로토콜

참고: Google Ads API는 표준 JSON REST 엔드포인트와 고성능 gRPC 인터페이스를 모두 노출합니다. Perl은 gRPC 스택에서 지원되는 언어가 아니므로 이 클라이언트 라이브러리는 HTTP 1.1을 통한 JSON REST 프로토콜에 구현됩니다.

Perl 클라이언트 라이브러리의 클래스 항목(예: 서비스, 리소스, enum, 오류)은 프로토콜 버퍼 정의를 파싱하여 생성됩니다. 구조화된 데이터가 직렬화되는 방식에 대해 자세히 알아보려면 프로토콜 버퍼 문서를 참조하세요.

Google Ads API에 연결하기 위해 클라이언트 라이브러리는 JSON으로 HTTP 요청을 만들고, HTTP 1.1을 통해 REST 엔드포인트로 전송하고, 응답을 JSON 객체로 역직렬화하고, 결과를 해석합니다.

라이브러리 설치

Perl 클라이언트 라이브러리는 GitHub에서 호스팅되며 CPAN을 사용하여 배포됩니다.

CPAN에서 설치

cpanm (또는 cpan)를 사용하여 CPAN에서 직접 Google::Ads::GoogleAds::Client 배포를 설치합니다.

cpanm Google::Ads::GoogleAds::Client

참고: 각 Google::Ads::GoogleAds::Client 출시 버전은 lib/Google/Ads/GoogleAds/ 아래에 특정 Google Ads API 버전 모듈을 번들로 묶습니다. 여기서 v25.1와 같은 부 버전 API 출시 버전은 주 버전 모듈 V25 아래에 포함됩니다. 버전 호환성은 지원되는 API 버전 표를 참고하세요.

소스에서 빌드 및 예시 실행

번들로 제공되는 코드 예시를 실행하거나 소스에서 라이브러리를 빌드하려면 다음 단계를 따르세요.

1. GitHub에서 라이브러리를 클론합니다.

   git clone https://github.com/googleads/google-ads-perl.git
   

2. google-ads-perl 디렉터리로 변경합니다.

   cd google-ads-perl
   

   몇 가지 파일과 하위 디렉터리가 표시됩니다.

   • Build.PL: 이 프로젝트의 종속 항목과 테스트 유형을 포함하는 Perl 빌드 파일입니다.
   • lib: 라이브러리의 소스 코드입니다.
   • t: 라이브러리 코드의 테스트 사례
   • examples: 라이브러리를 사용하여 Google Ads API를 사용하는 일반적인 사용 사례를 실행하는 방법을 보여주는 다양한 예시입니다.
   • googleads.properties: 라이브러리의 샘플 구성 파일입니다.
   • log4perl.conf: 샘플 로깅 구성 파일입니다.

3. 필수 종속 항목을 설치하고 라이브러리를 빌드합니다. Build.PL 파일에는 라이브러리에 필요한 모든 종속 항목이 나열됩니다. 다음 명령어를 실행하여 설치할 수 있습니다.

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

첫 번째 API 호출하기

Google Ads API를 사용하려면 몇 가지 단계를 수행하여 API에 액세스하고 Google Ads 계정을 구성해야 합니다. Google Ads 계정 설정을 비롯한 모든 중요한 단계를 안내하는 빠른 시작 가이드를 따르세요.

기본 사용법

Google::Ads::GoogleAds::Client를 초기화하고 (기본적으로 ~/googleads.properties 또는 GOOGLE_ADS_CONFIGURATION_FILE_PATH에서 사용자 인증 정보를 로드함) SearchStreamHandler를 사용하여 캠페인 행을 스트리밍합니다.

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

Perl 클라이언트 라이브러리를 사용하는 방법에 관한 자세한 내용은 기본 사용 가이드를 참고하세요.

인증 및 승인

Perl 클라이언트 라이브러리는 인증 및 승인에 대한 여러 접근 방식을 지원합니다. 자세한 내용은 인증 및 승인 가이드를 참고하세요.

구성 및 로깅

Perl 클라이언트 라이브러리는 구성에 googleads.properties를 사용하고 로깅에 log4perl.conf를 사용합니다. 이러한 파일을 수정하여 라이브러리의 동작을 맞춤설정할 수 있습니다. 자세한 내용은 구성 및 로깅 가이드를 참고하세요.

유틸리티

Perl 클라이언트 라이브러리에는 API 사용성을 개선하는 유틸리티 클래스가 포함되어 있습니다. 자세한 내용은 다음 가이드를 참조하세요.

• 필드 마스크
• 리소스 이름

애플리케이션 성능 미세 조정

애플리케이션 성능을 미세 조정하는 방법에 대한 권장사항은 성능 가이드를 참조하세요.