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

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

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

설치

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

<!-- 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>48.0.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 호출하기

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

기본 사용법

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

인증 및 승인

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

구성 및 로깅

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

유틸리티

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

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

애플리케이션 세부 조정

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