개요

Python 클라이언트 라이브러리는 GitHub에 호스팅되며 패키지는 PyPI에서 사용할 수 있습니다.

요구사항

이 라이브러리에는 Python 3.8 이상이 필요합니다.

기본 요건

라이브러리를 설치하기 전에 개발자 토큰과 클라이언트 고객 ID가 필요합니다. 이러한 도구를 가져오는 방법에 관한 안내는 기본 요건 섹션에 설명되어 있습니다. 나중에 필요한 다른 OAuth2 토큰을 생성합니다.

런타임 및 종속 항목 호환성

Python 클라이언트 라이브러리는 '기능' 또는 '사전 출시' 상태인 버전을 제외하고 Python Software Foundation에서 게시한 지원되는 버전 섹션의 Python 런타임과의 호환성을 유지합니다.

Google은 새로운 버전의 Python 런타임을 채택할 때 최신 런타임과 호환되는 Python 클라이언트 라이브러리의 새 버전을 출시 후 분기 말까지 출시하는 것을 목표로 합니다. 예를 들어 10월에 새 런타임이 출시되면 다음 해 3월 말까지 호환되는 버전의 Python 클라이언트 라이브러리를 사용할 수 있습니다.

지원 종료(EOL)에 도달한 Python 런타임은 python.org지원되지 않는 버전 섹션에 있는 지원 종료 날짜 이후에는 지원되지 않습니다.

EOL에 도달한 후에는 언제든지 지원되지 않는 Python 런타임과 호환되지 않는 Python 클라이언트 라이브러리 버전을 출시할 수 있습니다.

종속 항목(특히 Python 클라이언트 라이브러리에서 필수로 표시된 Google에서 유지관리하는 모든 패키지)의 경우 Google에서 유지관리하고 Google의 OSS 중단 변경사항 정책에 따라 '지원됨'으로 간주되는 패키지와의 호환성을 유지합니다.

지원되는 Python 런타임과 종속 항목의 전체 목록은 종속 항목 페이지를 참조하세요.

설치

설치 문서의 안내에 따라 PyPi에서 라이브러리를 설치하고 이 페이지로 돌아옵니다.

구성

라이브러리를 설치한 후에는 구성을 설정해야 합니다. 라이브러리를 구성하는 방법에는 여러 가지가 있으며 이는 구성 문서에 설명되어 있습니다.

인증

구성 유형을 선택한 후에는 API 요청에 필요한 나머지 OAuth2 토큰을 생성할 수 있습니다. 지원되는 OAuth2 흐름은 여러 개 있으며 아래 목록에 설명되어 있습니다. 흐름 간의 차이점과 애플리케이션에 가장 적합한 흐름을 결정하는 방법에 대한 자세한 내용은 OAuth 문서를 참조하세요.

API 요청 실행

OAuth2 토큰을 구성에 통합했으면 API 요청을 할 수 있습니다. 라이브러리가 API 요청을 하도록 올바르게 구성되었는지 테스트하는 간단한 방법은 get campaigns 예시를 참고하세요.

get_campaigns.py 샘플을 실행하려면 로컬에 설치된 googleads-python 클라이언트 라이브러리의 루트 디렉터리에서 다음 명령어를 실행합니다.

$ python examples/basic_operations/get_campaigns.py -c \
  INSERT_YOUR_CUSTOMER_ID_HERE

추가 리소스

API 요청을 할 수 있게 되면 다음과 같이 클라이언트 라이브러리 사용을 진행합니다.