클라이언트 라이브러리

Google의 클라이언트 라이브러리는 Google Ads API 기능의 대략적인 구성 요소와 기본 구성 요소를 제공하므로 앱을 더 쉽게 개발할 수 있습니다. API를 처음 사용하는 경우 API 하나로 시작하는 것이 좋습니다.

클라이언트 라이브러리 출처 분포 코드 예
자바 google-ads-java Maven, tar.gz GitHub에서 보기
.NET google-ads-dotnet nuget, tar.gz, zip GitHub에서 보기
PHP google-ads-php tar.gz GitHub에서 보기
Python google-ads-python tar.gz, zip GitHub에서 보기
Ruby google-ads-ruby gem, tar.gz, zip GitHub에서 보기
google-ads-perl tar.gz, zip GitHub에서 보기

지원되는 API 버전

아래 표에는 사용 가능한 각 API 버전을 지원하는 특정 라이브러리 버전이 나와 있습니다.

자바

API 및 지원되는 최소/최대 자바 버전
버전 12 Min: 22.0.0
Max:
v11 Min: 19.0.0
Max:
버전 10 Min: 17.0.0
Max:

C#

API 및 지원되는 최소/최대 .NET 버전
버전 12 Min: 14.2.0
Max: -
v11 Min: 12.1.0
Max:
버전 10 Min: 11.0.0
Max:

PHP

API 및 지원되는 최소/최대 PHP 버전
버전 12 Min: 17.1.0
Max:
v11 Min: 15.1.0
Max:
버전 10 Min: 14.0.0
Max:

Python

API 및 지원되는 최소/최대 Python 버전
버전 12 Min: 19.0.0
Max:
v11 Min: 17.0.0
Max:
버전 10 Min: 15.0.0
Max:

Ruby

API 및 지원되는 최소/최대 Ruby 버전
버전 12 Min: 20.0.0
Max:
v11 Min: 18.0.0
Max:
버전 10 Min: 16.0.0
Max:

Perl

API 및 지원되는 최소/최대 PERL 버전
버전 12 Min: 14.0.0
Max:
v11 Min: 12.0.0
Max:
버전 10 Min: 10.0.0
Max:

구성

각 Ads API 클라이언트 라이브러리는 동작을 맞춤설정하는 데 사용할 수 있는 다양한 구성 설정과 로드 메서드를 제공합니다.

다음은 모든 클라이언트 라이브러리에 공통되고 로드될 수 있는 구성 설정입니다.

  • 클라이언트 라이브러리
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: 구성 파일의 경로입니다.
  • OAuth2
    • 애플리케이션 모드
      • GOOGLE_ADS_CLIENT_ID: 이 값을 OAuth2 클라이언트 ID로 설정합니다.
      • GOOGLE_ADS_CLIENT_SECRET : 이 값을 OAuth2 클라이언트 보안 비밀로 설정합니다.
      • GOOGLE_ADS_REFRESH_TOKEN: OAuth2 토큰을 재사용하려면 이 값을 사전 생성된 OAuth2 갱신 토큰으로 설정합니다. 이 설정은 선택사항입니다.
    • 서비스 계정 모드
      • GOOGLE_ADS_JSON_KEY_FILE_PATH : 이 값을 OAuth2 JSON 구성 파일 경로로 설정합니다.
      • GOOGLE_ADS_IMPERSONATED_EMAIL: 이 값을 가장하려는 계정의 이메일 주소로 설정합니다.
  • Google Ads API
    • GOOGLE_ADS_DEVELOPER_TOKEN : 개발자 토큰으로 설정합니다.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : 하이픈 (-) 없이 요청에서 사용하도록 승인된 고객의 고객 ID입니다.
    • GOOGLE_ADS_LINKED_CUSTOMER_ID: 이 헤더는 Google Ads UI(Google Ads API의 AccountLink 리소스)에서 연결된 계정을 통해 권한이 부여될 때 항목의 리소스를 업데이트하는 메서드에만 필요합니다. 이 값을 지정된 고객 ID의 리소스를 업데이트하는 데이터 제공업체의 고객 ID로 설정합니다. 하이픈(-) 없이 설정해야 합니다. 연결된 계정에 대해 자세히 알아보려면 고객센터를 방문하세요.