기본 사용법

Java 클라이언트 라이브러리의 기본 사용법은 다음과 같습니다.

새 Maven 또는 Gradle 프로젝트 만들기

원하는 IDE에서 새 Maven 또는 Gradle 프로젝트를 만듭니다. 아티팩트는 Maven Central 저장소에 게시됩니다.

Google Ads API 재료명세서 (BOM)를 사용하여 종속 항목 버전을 관리합니다.

google-ads-examples 모듈에 포함된 사전 패키지 코드 예시를 실행하려면 GitHub에서 google-ads-java 저장소를 클론하거나 소스에서 빌드하세요. 소스에서 빌드하는 경우 IDE에서 주석 처리를 사용 설정해야 합니다.

API 액세스 구성

Google Ads API에 연결하려면 인증 및 승인 사용자 인증 정보를 제공해야 합니다. 필요한 사용자 인증 정보 및 클라이언트 라이브러리 구성 방법에 대한 자세한 내용은 인증 및 승인 가이드를 참고하세요.

첫 번째 통화하기

사용자 인증 정보를 구성하면 첫 번째 API 호출을 할 수 있습니다.

사용자 인증 정보를 검증하고 클론된 google-ads-java 저장소를 사용하여 첫 번째 호출을 하려면 GetCampaigns 예시를 실행합니다.

먼저 google-ads-examples 디렉터리로 이동합니다.

cd google-ads-examples

이 예에서는 값이 하이픈이 없는 Google Ads 계정 고객 ID (-)인 --customerId 매개변수가 필요합니다.

Gradle로 실행하려면 다음을 실행하세요.

./gradlew -q runExample \
  --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"

Maven으로 실행하려면 다음을 실행하세요.

mvn exec:java \
  -Dexec.mainClass="com.google.ads.googleads.examples.basicoperations.GetCampaigns" \
  -Dexec.args="--customerId INSERT_CUSTOMER_ID_HERE"

다른 예시 살펴보기

google-ads-examples의 examples 패키지에는 유용한 예가 몇 개 포함되어 있습니다. 대부분의 예시에는 매개변수가 필요합니다. 매개변수를 인수로 전달하거나 (권장) 소스 코드에서 INSERT_..._HERE 자리표시자 값을 수정할 수 있습니다. 예시의 사용법을 보려면 --help를 유일한 인수로 전달하세요.

Gradle 사용:

./gradlew -q runExample --example="basicoperations.GetCampaigns --help"

Gradle에서 listExamples 작업을 사용하여 모든 예, 하위 디렉터리의 예 또는 설명에 검색어가 포함된 예를 나열할 수도 있습니다.

# List all examples:
./gradlew -q listExamples
# List examples in the 'basicoperations' subdirectory:
./gradlew -q listExamples --subdirectory='basicoperations'
# Search for examples where the description includes 'Performance Max':
./gradlew -q listExamples --searchTerm='Performance Max'