설치

PyPI에서 라이브러리를 설치하든 GitHub에서 클론하든 활성 가상 환경을 사용하여 다음 단계를 실행합니다. 가상 환경을 만들고 활성화하는 방법은 가상 환경 문서를 참고하세요.

가상 환경을 빠르게 만들고 활성화하려면 다음 단계를 따르세요.

python3 -m venv env
source env/bin/activate

PyPI에서 모듈 설치

이 라이브러리는 PyPI에 배포되며 다음 명령어를 사용하여 pip로 설치할 수 있습니다.

python -m pip install google-ads

설치 확인

모듈이 올바르게 설치되었는지 확인합니다.

python -c "import google.ads.googleads"

GitHub에서 라이브러리 설치

라이브러리의 소스 코드는 GitHub에서 로컬 머신으로 클론할 수 있습니다. 소스 코드를 클론하면 예시를 실행하거나 라이브러리 자체를 개발하는 데 유용합니다. 참고로 인증 예시 중 하나를 실행하는 것은 라이브러리 사용을 구성하는 데 필요한 단계입니다.

1. 지원되는 Python 버전 (Python 3.9~3.14, Python 3.11 이상 권장)이 환경에 있는지 확인합니다. 가장 간단한 방법은 pyenv를 사용하는 것입니다.

   pyenv install 3.13
   pyenv local 3.13

2. GitHub에서 클라이언트 라이브러리를 클론합니다.

   git clone https://github.com/googleads/google-ads-python.git

3. 저장소로 이동하여 편집 가능한 모드로 설치합니다.

   cd google-ads-python
   python -m pip install -e .

4. 라이브러리를 개발하려는 경우 변경하기 전후에 단위 테스트를 실행하세요.

   1. pyenv를 사용하여 환경에서 지원되는 모든 버전의 Python 언어를 사용할 수 있는지 확인합니다.

      pyenv local 3.9 3.10 3.11 3.12 3.13 3.14

   2. 라이브러리의 테스트 관련 종속 항목을 설치합니다.

      python -m pip install -e ".[tests]"

   3. 단위 테스트를 실행하여 라이브러리가 올바르게 작동하는지 확인합니다.

      nox

   4. 선택사항: Docker를 사용하여 단위 테스트를 실행할 수도 있습니다. 먼저 Docker가 설치되어 있는지 확인합니다. 그런 다음 google-ads-python 디렉터리에서 다음 명령어를 실행합니다.

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox