Установка

Независимо от того, устанавливаете ли вы библиотеку из PyPI или клонируете ее из GitHub, выполните следующие действия, используя активную виртуальную среду. Информацию о том, как создать и активировать виртуальную среду, можно найти в документации Virtual Environment.

Чтобы быстро создать и активировать виртуальную среду:

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 (от 3.9 до 3.14; рекомендуется 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. Убедитесь, что в вашей среде доступны все поддерживаемые версии языка Python, используя команду pyenv:

      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