설치
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
PyPI에서 라이브러리를 설치하든 GitHub에서 클론하든 활성 가상 환경을 사용하여 아래 단계를 수행하는 것이 좋습니다. 가상 환경을 만들고 활성화하는 방법은 가상 환경 문서를 참고하세요.
PyPI에서 모듈 설치
이 라이브러리는 PyPI에 배포되며 다음 명령어를 사용하여 pip로 설치할 수 있습니다.
python -m pip install google-ads
GitHub에서 라이브러리 설치
라이브러리의 소스 코드는 GitHub에서 로컬 머신으로 클론할 수 있습니다. 예를 쉽게 실행하거나 라이브러리 자체를 개발하려면 소스 코드를 클론하는 것이 좋습니다. 참고로 인증 예 중 하나를 실행하는 것은 라이브러리를 사용하도록 구성하는 데 필요한 단계입니다.
환경에 python3.8 이상이 있는지 확인합니다.
가장 간단한 방법은 pyenv를 사용하는 것입니다.
pyenv local 3.8
GitHub에서 클라이언트 라이브러리를 클론합니다.
git clone git@github.com:googleads/google-ads-python.git
저장소를 입력하고 설치합니다.
cd google-ads-python
python -m pip install .
라이브러리를 개발하려는 경우 변경하기 전후에 단위 테스트를 실행하세요.
환경에서 지원되는 모든 버전의 Python 언어를 사용할 수 있는지 확인합니다. pyenv 사용:
pyenv local 3.8 3.9 3.10 3.11 3.12
라이브러리의 테스트 관련 종속 항목을 설치합니다.
python -m pip install .[tests]
단위 테스트를 실행하여 라이브러리가 올바르게 작동하는지 확인합니다.
nox
선택사항: 단위 테스트는 Docker를 사용하여 실행할 수도 있습니다. 먼저 Docker가 설치되어 있어야 합니다. 그런 다음 google-ads-python 디렉터리에서 다음을 실행합니다.
docker build -t google-ads-python:test .
docker run -it google-ads-python:test nox
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\u003cp\u003eThe Google Ads Python library can be installed from PyPI using pip with the command \u003ccode\u003epython -m pip install google-ads\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eTo install from GitHub, clone the repository, navigate into it, and run \u003ccode\u003epython -m pip install .\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnsure you have Python 3.8 or later installed in your environment, potentially using pyenv.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers should run unit tests before and after making changes, utilizing nox or Docker for execution.\u003c/p\u003e\n"],["\u003cp\u003eFor library setup and usage, refer to the Virtual Environment and authentication example documentation.\u003c/p\u003e\n"]]],[],null,["# Installation\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhether you're installing the library from PyPI or cloning it from GitHub, we\nrecommended that you conduct the below steps using an active virtual\nenvironment. For information on how to create and activate a virtual\nenvironment, see the [Virtual Environment](//docs.python.org/3/tutorial/venv.html) documentation.\n\nInstall the module from PyPI\n----------------------------\n\nThe library is distributed on [PyPI](//pypi.org/project/google-ads/) and can\nbe installed using [pip](//pip.pypa.io/en/stable/installing) with the\nfollowing command: \n\n python -m pip install google-ads\n\nInstall the library from GitHub\n-------------------------------\n\nThe source code for the library can be cloned from [GitHub](https://github.com/googleads/google-ads-python/)\nonto your local machine. It's useful to clone the source code in order to easily\nexecute the examples or to develop the library itself. For reference, running\none of the authentication examples is a required step in configuring the library\nfor use.\n\n1. Ensure that `python3.8` or later is present in your environment.\n The simplest way is to use [`pyenv`](//github.com/pyenv/pyenv-installer):\n\n pyenv local 3.8\n\n2. Clone the client library from GitHub:\n\n git clone git@github.com:googleads/google-ads-python.git\n\n3. Enter the repository and install it:\n\n cd google-ads-python\n python -m pip install .\n\n4. If you intend to develop the library, run the unit tests before and after\n making any changes:\n\n 1. Ensure you have all supported versions of the Python language available in\n your environment. Using `pyenv`::\n\n pyenv local 3.8 3.9 3.10 3.11 3.12\n\n 2. Install the test-specific dependencies of the library:\n\n python -m pip install .[tests]\n\n 3. Run the unit tests to ensure the library is functioning properly:\n\n nox\n\n 4. Optional: the unit tests can also be run using Docker. First, you must\n have [Docker installed](https://docs.docker.com/get-docker/). Then, from\n the `google-ads-python` directory, run the following:\n\n docker build -t google-ads-python:test .\n docker run -it google-ads-python:test nox"]]
