이 가이드에서는 자체 사용자 인증 정보와 데스크톱 흐름 또는 웹 흐름을 사용하여 API 액세스를 위해 OAuth2를 설정하는 방법을 설명합니다. 이 단계는 OAuth2 사용자 인증 정보에 허용되는 범위를 취소하거나 삭제하거나 변경해야 하는 경우가 아니라면 한 번만 수행하면 됩니다.
OAuth2 사용자 인증 정보 만들기
Google Ads API용 Google API 콘솔 프로젝트 구성 단계를 따릅니다.
먼저 OAuth 클라이언트 다운로드 아이콘을 클릭한 후 다음 화면에서 JSON 다운로드 버튼을 클릭하여 클라이언트의 JSON 파일을 다운로드합니다.
이제 로컬 파일
~/client_secret_XXX.apps.googleusercontent.com.json
를 확보하도록 파일을 홈 디렉터리에 저장합니다. 여기서 XXX는 프로젝트와 관련된 값입니다. 다음 단계에서 이 파일을 사용하여 코드 예시를 실행합니다.
클라이언트 라이브러리 설정
터미널에서
GenerateUserCredentials
예를 실행합니다. 명령줄 플래그를 사용하여 이전 단계에서 다운로드한 JSON 파일을 전달합니다.Gradle을 사용하여 명령줄에서 실행하려면
./gradlew --console=plain --quiet runExample \ --example="authentication.GenerateUserCredentials \ --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
이 예에서는 OAuth2 사용자 인증 정보가 광고주를 대신하여 Google Ads 계정에 액세스하도록 허용해야 하는 URL을 방문하라는 메시지를 표시합니다.
Paste this URL in your browser: https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
시크릿 브라우저 세션 또는 시크릿 창에서 URL로 이동합니다. Google Ads에 액세스할 때 사용하는 것과 동일한 Google 계정으로 로그인합니다. OAuth2 동의 화면에서 계속을 클릭합니다.
승인이 완료되었음을 나타내는 메시지가 있는 페이지로 이동합니다.
승인 코드를 가져왔습니다.
자세한 안내는
GenerateUserCredentials
의 콘솔 출력을 확인하세요.예시를 실행 중인 콘솔로 돌아갑니다. 예시가 완료되고 갱신 토큰과 몇 가지 안내가 표시된 후 클라이언트 라이브러리를 구성하는 데 필요한 속성이 표시됩니다.
#Mon Apr 18 09:07:51 EDT 2022 api.googleads.refreshToken=1/Yw......................................... api.googleads.clientId=...........-...............apps.googleusercontent.com api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE api.googleads.clientSecret=........................
날짜 주석
#
의 줄을ads.properties
파일의 출력 끝에 복사합니다.INSERT_DEVELOPER_TOKEN_HERE
를 개발자 토큰으로 바꿉니다.가장 쉬운 설정을 위해
ads.properties
파일을 홈 디렉터리에 배치합니다.