자바 클라이언트 라이브러리의 기본 사용법은 다음과 같습니다.
새 Maven 또는 Gradle 프로젝트 만들기
선택한 IDE에서 새 Maven 또는 Gradle 프로젝트를 만듭니다. Google 아티팩트 는 Maven 중앙 저장소에 게시됩니다.
종속 항목 버전을 관리하려면 Google Ads API의 재료명세서 (BOM)를 사용하는 것이 좋습니다.
소스에서 빌드할 수도 있습니다. 이 가이드에서는 필요한 종속 항목을 사용할 수 있는 프로젝트 설정이 있다고 가정합니다.
소스에서 빌드하는 경우 IDE에서 주석 처리를 사용 설정해야 합니다.
API 액세스 구성
Google Ads API에 연결하려면 인증 및 승인 사용자 인증 정보를 제공해야 합니다. 필요한 사용자 인증 정보 및 클라이언트 라이브러리를 구성하는 방법에 대한 자세한 내용은 인증 및 승인 가이드를 참고하세요.
첫 번째 호출하기
사용자 인증 정보를 구성한 후 첫 번째 API 호출을 할 수 있습니다.
사용자 인증 정보를 확인하고 첫 번째 호출을 하려면 GetCampaigns 예시를 실행합니다.
먼저 google-ads-examples 디렉터리로 이동합니다.
cd google-ads-examples
이 예시에는 값이 대시가 없는 Google Ads 계정 고객 ID인 --customerId 매개변수가 필요합니다.
Gradle로 실행하려면 다음 단계를 따르세요.
./gradlew -q runExample --example="basicoperations.GetCampaigns --customerId INSERT_CUSTOMER_ID_HERE"
다른 예시 살펴보기
google-ads-examples
의 examples 패키지에는 몇 가지 유용한 예시가 포함되어 있습니다. 대부분의 예시에는 매개변수가 필요합니다. 매개변수를 인수로 전달하거나 (권장) 소스 코드에서 INSERT_XXXXX_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'