Python 스크립트를 사용하여 Data Portability API 호출

이 빠른 시작에서는 계정의 OAuth 토큰을 가져오고 Python 스크립트를 사용하여 Data Portability API 엔드포인트에 요청을 전송합니다.

학습 내용

이 빠른 시작에서는 Python 스크립트를 사용하여 다음을 수행합니다.

  • 유효한 OAuth 토큰을 제공하여 인증된 요청을 InitiatePortabilityArchive 엔드포인트에 전송합니다. 응답은 유효한 job_id입니다.
  • 인증된 요청을 GetPortabilityArchiveState 엔드포인트로 전송하고 데이터를 다운로드합니다. 응답에는 유효한 작업 상태가 포함되어야 하며 작업이 완료되면 서명된 URL이 포함되어야 합니다.
  • 인증된 요청을 ResetAuthorization 엔드포인트로 전송합니다. 이 요청은 사용자가 부여한 모든 OAuth 범위가 취소됩니다.

기본 요건

이 빠른 시작을 실행하려면 다음을 수행해야 합니다.

  • Data Portability API를 사용할 수 있는지 확인합니다. 지원되는 국가 및 지역 목록은 '서드 파티와 데이터 사본 공유' 페이지의 일반적인 질문을 참조하세요.
  • Data Portability API의 설정 단계를 완료하고 새 프로젝트를 사용 중인지 확인합니다.
  • 조직에서 소유하거나 관리하는 계정에 대한 액세스 권한을 얻습니다. 이 계정의 검색 활동 데이터는 이 빠른 시작에서 내보냅니다.

이 빠른 시작을 시작하기 전에 Python 클라이언트 라이브러리용 OAuth, Python, OAuth 패키지도 설정해야 합니다.

OAuth 설정

  • 설치된 애플리케이션에 OAuth를 구성하는 단계를 따릅니다. 이 흐름은 웹 서버 애플리케이션의 OAuth 흐름과 비슷합니다. OAuth 클라이언트 ID를 구성할 때 다음을 수행하세요.
    • 애플리케이션 유형이 데스크톱 앱이어야 합니다.
    • 클라이언트 ID를 만든 후 JSON 형식의 클라이언트 보안 비밀번호를 다운로드하고 파일 이름을 client_secrets.json로 지정합니다.
    • Data Portability API의 범위를 구성할 때 이 빠른 시작에서는 다음 리소스 그룹을 사용합니다.

Python 설정

이 빠른 시작에 사용된 스크립트를 실행하려면 로컬 머신에 Python을 설정해야 합니다. Python을 설정하려면 다음 안내를 따르세요.

  • Pip 패키지 관리 도구와 Python 3.9 이상을 설치합니다.
  • Python용 Google API 클라이언트 라이브러리를 설치합니다.

  • 다음 명령어를 실행하여 Python 클라이언트 라이브러리의 google_auth_oauthlib 패키지를 설치합니다. 이 패키지는 Python용 Google 인증 라이브러리인 google-auth와 oauthlib 통합을 제공합니다.

    pip install google-auth-oauthlib google-api-python-client --upgrade

스크립트 실행

이 스크립트는 OAuth 흐름에서 localhost 리디렉션을 사용합니다. 이 옵션을 사용하려면 애플리케이션이 localhost 포트에서 리슨한 후 시스템 브라우저를 열어 OAuth 승인 흐름을 시작해야 합니다.

이 링크를 클릭하여 스크립트를 열거나 링크를 마우스 오른쪽 버튼으로 클릭하여 스크립트 사본을 다운로드합니다.

Data Portability API Python 빠른 시작 스크립트

스크립트를 실행하려면 다음 명령어를 입력합니다.

python3 data-portability-quickstart.py

스크립트에서 수행한 작업은 주석에 자세히 설명되어 있습니다.