Java용 Google Ads API 클라이언트 라이브러리

Java용 클라이언트 라이브러리는 GitHub에서 호스팅되고 Maven Central을 통해 배포됩니다. 사용자 인증 정보의 간편한 관리, Google Ads API 서비스 클라이언트 생성 등 API 사용을 지원하는 여러 기능을 제공합니다.

이 라이브러리에는 Java 8 이상이 필요합니다.

설치

pom.xml 또는 build.gradle 파일에서 Google Ads API BOM (Bill of Materials)을 사용하여 종속 항목 버전을 관리합니다.

<!-- Import the Bill of Materials (BOM) to ensure you're using compatible
     versions of all google-ads libraries. -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.google.api-ads</groupId>
      <artifactId>google-ads-bom</artifactId>
      <version>46.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add the google-ads dependency, without a version. The version is
     managed by the BOM. -->
<dependency>
  <groupId>com.google.api-ads</groupId>
  <artifactId>google-ads</artifactId>
</dependency>

소스에서 라이브러리를 빌드할 수도 있습니다.

첫 번째 API 호출하기

동영상 라이브러리: Java 클라이언트 라이브러리 시작하기

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

기본 사용법

기본 사용 가이드를 참고하여 Java 클라이언트 라이브러리로 프로젝트를 설정하고, 서비스 클라이언트를 인스턴스화하고, 코드 예시를 실행하는 방법을 알아보세요.

인증 및 승인

Java 클라이언트 라이브러리는 OAuth 2.0 데스크톱 및 웹 애플리케이션 흐름, 서비스 계정, 애플리케이션 기본 사용자 인증 정보를 비롯한 다양한 인증 및 승인 방법을 지원합니다. 자세한 내용은 인증 및 승인 가이드를 참고하세요.

구성 및 로깅

Java 클라이언트 라이브러리는 API 요청 및 응답을 추적하기 위한 여러 구성 옵션(ads.properties 파일, 환경 변수, 프로그래매틱 구성 포함)과 로깅 기능을 지원합니다.

유틸리티

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

  • FieldMasks: 업데이트 필드 마스크를 구성하고 계산하는 도우미입니다.
  • ResourceNames: 엔티티 리소스 이름 문자열의 형식을 지정하는 유틸리티입니다.
  • 장기 실행 작업: 비동기 API 작업을 모니터링하고 관리하는 도우미입니다.

애플리케이션 세부 조정

애플리케이션의 제한 시간, 재시도 설정, 시작 지연 시간, 종속 항목 관리를 미세 조정하는 방법에 관한 권장사항은 고급 사용 가이드를 참고하세요.