Python 클라이언트 라이브러리는 GitHub에 호스팅되며 패키지는 PyPI에서 제공됩니다.
요구사항
이 라이브러리에는 Python 3.8 이상이 필요합니다.
기본 요건
라이브러리를 설치하려면 개발자 토큰과 클라이언트 고객 ID가 필요합니다. 이를 획득하는 방법은 기본 요건 섹션에 설명되어 있습니다. 나중에 다른 필수 OAuth2 토큰을 생성합니다.
런타임 및 종속 항목 호환성
Python 클라이언트 라이브러리는 Python Software Foundation에서 게시한 지원되는 버전 섹션의 Python 런타임과 호환됩니다('기능' 또는 '사전 출시' 상태의 버전 제외).
새로운 버전의 Python 런타임을 채택할 때 Google은 출시 후 다음 분기 말까지 최신 런타임과 호환되는 새로운 버전의 Python 클라이언트 라이브러리를 출시하는 것을 목표로 합니다. 예를 들어 10월에 새 런타임이 출시되면 호환되는 버전의 Python 클라이언트 라이브러리가 다음 해 3월 말까지 제공됩니다.
지원 종료 (EOL)에 도달한 Python 런타임은 python.org의 지원되지 않는 버전 섹션에 명시된 지원 종료일 이후에는 지원되지 않습니다.
지원되지 않는 Python 런타임이 EOL에 도달한 후 언제든지 지원되지 않는 Python 런타임과 호환되지 않는 Python 클라이언트 라이브러리 버전이 출시될 수 있습니다.
종속 항목(특히 Python 클라이언트 라이브러리에서 필수 항목으로 나열된 Google 유지관리 패키지)의 경우 Google에서 유지관리하고 Google의 OSS 호환성 파괴 변경 정책에 따라 '지원'되는 것으로 간주되는 패키지와의 호환성을 유지합니다.
지원되는 Python 런타임 및 종속 항목의 전체 목록은 종속 항목 페이지를 참고하세요.
설치
설치 문서의 안내에 따라 PyPi에서 라이브러리를 설치하고 이 페이지로 돌아옵니다.
구성
라이브러리를 설치한 후에는 라이브러리의 구성을 설정해야 합니다. 라이브러리를 구성하는 방법에는 여러 가지가 있으며, 이는 구성 문서에 설명되어 있습니다.
인증
구성 유형을 선택했으면 API에 요청하는 데 필요한 나머지 OAuth2 토큰을 생성하면 됩니다. 지원되는 OAuth2 흐름은 여러 개이며 아래 목록에 설명되어 있습니다. 흐름 간의 차이점과 애플리케이션에 가장 적합한 흐름을 결정하는 데 도움이 되는 내용은 OAuth 문서를 참고하세요.
API 요청하기
OAuth2 토큰을 구성에 통합하면 API 요청을 할 수 있습니다. 라이브러리가 API 요청을 수행하도록 올바르게 구성되었는지 테스트하는 간단한 방법은 캠페인 가져오기 예시를 참고하세요.
get_campaigns.py 샘플을 실행하려면 로컬에 설치된 googleads-python 클라이언트 라이브러리의 루트 디렉터리에서 다음 명령어를 실행합니다.
$ python examples/basic_operations/get_campaigns.py -c \
INSERT_YOUR_CUSTOMER_ID_HERE
추가 리소스
API 요청을 할 수 있게 되면 다음 클라이언트 라이브러리 사용으로 진행합니다.