Perl 클라이언트 라이브러리

Perl 클라이언트 라이브러리는 GitHub에 호스팅되며 패키지는 CPAN에서 제공됩니다.

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

REST API 프로토콜

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

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

라이브러리 설치

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

  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
perl Build installdeps

첫 번째 API 호출하기

Google Ads API를 사용하려면 API에 액세스하고 Google Ads 계정을 구성하는 여러 단계를 실행해야 합니다. Google Ads 계정 설정 등 중요한 단계를 모두 안내하는 빠른 시작 가이드를 따르는 것이 좋습니다.

기본 사용법

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

인증 및 승인

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

구성 및 로깅

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

유틸리티

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

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

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