Java 클라이언트 라이브러리의 기본 사용법은 다음과 같습니다.
새 Maven 또는 Gradle 프로젝트 만들기
원하는 IDE에서 새 Maven 또는 Gradle 프로젝트를 만듭니다. 아티팩트는 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'