Python 클라이언트 라이브러리는 GitHub에서 호스팅되며 패키지는 PyPI에서 사용할 수 있습니다.
요구사항
이 라이브러리는 Python 3.9~3.14를 지원합니다 (>=3.9, <3.15, Python 3.14 지원은 v28.2.0에 추가됨). Python 3.9 및 3.10은 google-ads v32.0.0 이상에서 가져올 때 지원 중단 경고를 표시하므로 Python 3.11 이상을 사용하는 것이 좋습니다.
기본 요건
이 가이드를 진행하기 전에 Google Ads 계정의 10자리 클라이언트 고객 ID가 필요합니다.
런타임 및 종속 항목 호환성
Python 클라이언트 라이브러리는 '기능' 또는 '사전 출시' 상태의 버전을 제외하고 Python Software Foundation에서 게시한 지원되는 버전 섹션의 Python 런타임과 호환성을 유지합니다.
Google Ads API팀은 Python Software Foundation에서 새 버전의 Python 런타임을 출시하고 공식적으로 지원하는 즉시 이를 채택하는 것을 목표로 합니다.
지원 종료 (EOL)에 도달한 Python 런타임은 python.org의 지원되지 않는 버전 섹션에 있는 EOL 날짜 이후에는 지원되지 않습니다. EOL 날짜 이후의 라이브러리 출시로 인해 호환성이 손상될 수 있으므로 EOL 런타임과의 호환성은 보장되지 않습니다.
종속 항목 (특히 Python 클라이언트 라이브러리에서 필수로 나열된 Google 유지보수 패키지)의 경우 Google에서 유지보수하고 Google의 OSS 브레이킹 체인지 정책에 따라 '지원'되는 것으로 간주되는 패키지와의 호환성이 유지됩니다.
지원되는 Python 런타임 및 종속 항목의 전체 목록은 종속 항목 페이지를 참조하세요.
설치
설치 가이드에서는 라이브러리를 설치하는 다양한 방법을 간략하게 설명합니다. 애플리케이션에 라이브러리를 설치하는 가장 간단하고 권장되는 방법은 pip를 사용하는 것입니다.
python -m pip install google-ads
구성
라이브러리를 설치한 후에는 라이브러리 구성을 설정해야 합니다. 라이브러리를 구성하는 방법에는 여러 가지가 있으며, 이는 구성 가이드에 설명되어 있습니다.
인증
구성 방식을 선택했으면 인증 구성을 설정합니다. 단계별 안내는 Python 클라이언트 라이브러리 인증 가이드를 참조하세요. 일반적인 배경 정보는 OAuth 개요를 참조하세요.
API 요청하기
인증 구성을 설정했으면 API 요청을 수행할 수 있습니다. 캠페인 가져오기 예를 참고하여 라이브러리가 API 요청을 수행하도록 올바르게 구성되었는지 빠르게 테스트하세요.
get_campaigns.py 샘플을 실행하려면 먼저 google-ads-python 저장소를 클론합니다. 그런 다음 클론된 저장소의 루트 디렉터리에서 다음 명령어를 실행합니다.
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
추가 리소스
API 요청을 할 수 있게 되면 클라이언트 라이브러리의 다음 사용으로 진행합니다.