Установка

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

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

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 (Python 3.9–3.14; рекомендуется Python 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