설치

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