설치

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 [e-mail]: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