Установка

Независимо от того, устанавливаете ли вы библиотеку из 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