클라이언트 라이브러리

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 버전과 호환되는지 표시됩니다.

자바

자바용 클라이언트 라이브러리
v13 Min: 23.0.0
Max:~
v12 Min: 22.0.0
Max:~

C#

.NET용 클라이언트 라이브러리
v13 Min: 15.0.0
Max:~
v12 Min: 14.2.0
Max:~

2,399필리핀

PHP용 클라이언트 라이브러리
v13 Min: 18.0.0
Max:~
v12 Min: 17.1.0
Max:~

Python

Python용 클라이언트 라이브러리
v13 Min: 20.0.0
Max:~
v12 Min: 19.0.0
Max:~

Ruby

Ruby용 클라이언트 라이브러리
v13 Min: 21.0.0
Max:~
v12 Min: 20.0.0
Max:~

Perl

Perl용 클라이언트 라이브러리
v13 Min: 15.0.0
Max:~
v12 Min: 14.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로 설정합니다. 하이픈 (-) 없이 설정해야 합니다. 연결된 계정에 대해 자세히 알아보려면 고객센터를 방문하세요.