Установка

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