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

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

OAuth2 사용자 인증 정보 만들기

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

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

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

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

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

    generate_user_credentials.py \
      --client_secrets_path=${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. 그러면 승인이 완료되었다는 메시지가 표시된 페이지로 이동합니다.

    갱신 토큰을 가져왔습니다. 자세한 안내는 콘솔 출력을 확인하세요.

  4. 예시를 실행한 콘솔로 돌아갑니다. 이제 갱신 토큰과 클라이언트 라이브러리 구성 안내가 표시됩니다.

    Your refresh token is: 1/Yw.........................................
    Add your refresh token to your client library configuration as described here:
    https://developers.google.com/google-ads/api/docs/client-libs/python/configuration