Установка

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