OAuth 데스크톱 및 웹 애플리케이션 흐름

이 가이드에서는 자체 사용자 인증 정보와 데스크톱 흐름 또는 웹 흐름을 사용하여 API 액세스를 위해 OAuth2를 설정하는 방법을 설명합니다. 이 단계는 OAuth2 사용자 인증 정보에 허용되는 범위를 취소하거나 삭제하거나 변경해야 하는 경우를 제외하고 한 번만 하면 됩니다.

OAuth2 사용자 인증 정보 만들기

  1. Google Ads API를 위한 Google API 콘솔 프로젝트 구성 단계를 따릅니다.

  2. 먼저 OAuth 클라이언트 다운로드 아이콘을 클릭한 후 다음 화면에서 JSON 다운로드 버튼을 클릭하여 클라이언트의 JSON 파일을 다운로드합니다.

    이제 로컬 파일 ~/client_secret_XXX.apps.googleusercontent.com.json를 보유하도록 파일을 홈 디렉터리에 저장합니다. 여기서 XXX는 프로젝트에 해당하는 값입니다. 다음 단계에서 이 파일을 사용하여 코드 예를 실행합니다.

클라이언트 라이브러리 설정

  1. 터미널에서 GenerateUserCredentials 예를 실행합니다. 명령줄 플래그를 사용하여 이전 단계에서 다운로드한 JSON 파일을 전달합니다.

    Gradle을 사용하여 명령줄에서 실행

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. 이 예에서는 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 동의 화면에서 계속을 클릭합니다.

    동의 화면

  3. 승인에 성공했다는 메시지가 표시된 페이지로 이동합니다.

    승인 코드를 가져왔습니다.

    자세한 안내는 GenerateUserCredentials의 콘솔 출력을 확인하세요.

  4. 예를 실행 중인 콘솔로 돌아갑니다. 예시가 완료되고 갱신 토큰과 몇 가지 안내가 표시되고 그 뒤에 클라이언트 라이브러리를 구성하는 데 필요한 속성이 표시됩니다.

    #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=........................
    
  5. 날짜 주석 #의 줄을 출력 끝에 있는 줄을 ads.properties 파일에 복사합니다.

    INSERT_DEVELOPER_TOKEN_HERE를 개발자 토큰으로 바꿉니다.

    가장 쉬운 설정은 홈 디렉터리에 ads.properties 파일을 배치하는 것입니다.