설치

PyPI에서 라이브러리를 설치하든 GitHub에서 클론하든 활성 가상 환경을 사용하여 아래 단계를 수행하는 것이 좋습니다. 가상 환경을 만들고 활성화하는 방법에 관한 자세한 내용은 가상 환경 문서를 참고하세요.

PyPI에서 모듈 설치

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

python -m pip install google-ads

GitHub에서 라이브러리 설치

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

1. 환경에 python3.8 이상이 있는지 확인합니다. 가장 간단한 방법은 pyenv를 사용하는 것입니다.

   pyenv local 3.8
   

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

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

3. 저장소를 입력하고 설치합니다.

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

4. 라이브러리를 개발하려면 변경 전후에 단위 테스트를 실행합니다.

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

      pyenv local 3.8 3.9 3.10 3.11 3.12
      

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

      python -m pip install .[tests]
      

   3. 단위 테스트를 실행하여 라이브러리가 제대로 작동하는지 확인합니다.

      nox
      

   4. 선택사항: Docker를 사용하여 단위 테스트를 실행할 수도 있습니다. 먼저 Docker를 설치해야 합니다. 그런 다음 google-ads-python 디렉터리에서 다음을 실행합니다.

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