Клиентская библиотека Python размещена на GitHub , а пакет доступен на PyPI .
Требования
Для работы библиотеки требуется Python 3.9 или более поздней версии.
Предварительные требования
Прежде чем продолжить, вам потребуется токен разработчика для API Google Ads, а также 10-значный идентификатор клиента для вашего аккаунта Google Ads.
Совместимость во время выполнения и зависимостей
Клиентская библиотека Python сохраняет совместимость с средами выполнения Python, указанными в разделе «Поддерживаемые версии» , опубликованном Фондом программного обеспечения Python , за исключением версий со статусом «функция» или «предварительная версия».
Наша цель — внедрять новые версии среды выполнения Python сразу после их выпуска и официальной поддержки со стороны Python Software Foundation.
Поддержка библиотек Python, срок службы которых истек (EOL), прекращается после даты EOL, указанной в разделе «Неподдерживаемые версии» на сайте python.org . Мы не можем гарантировать совместимость с библиотеками EOL, поскольку после даты их окончания поддержки мы можем выпустить версию библиотеки, несовместимую с ними.
Что касается зависимостей (в частности, любых поддерживаемых Google пакетов, которые указаны как необходимые для клиентской библиотеки Python), мы будем поддерживать совместимость с пакетами, поддерживаемыми Google и считающимися «поддерживаемыми» в соответствии с политикой Google в отношении критических изменений в открытом доступе .
Полный список поддерживаемых сред выполнения Python и зависимостей см. на странице «Зависимости» .
Установка
В нашем руководстве по установке показаны все различные способы установки библиотеки. Самый простой (и рекомендуемый) способ установить библиотеку в ваше приложение — это использовать pip :
$ python -m pip install google-ads
Конфигурация
После установки библиотеки вам потребуется настроить для неё конфигурацию. Существует несколько способов настройки библиотеки, которые описаны в нашем руководстве по настройке .
Аутентификация
После выбора подхода к настройке вы можете настроить параметры аутентификации. Пошаговые инструкции см. в нашем руководстве по аутентификации с использованием клиентской библиотеки Python , а более подробную информацию см. в нашем обзоре OAuth .
Выполните API-запрос
После настройки параметров аутентификации вы готовы отправить API-запрос. Для быстрой проверки правильности настройки библиотеки для выполнения API-запросов обратитесь к примеру получения данных о кампаниях .
Чтобы запустить пример get_campaigns.py , в корневом каталоге локально установленной клиентской библиотеки googleads-python выполните следующую команду:
$ python examples/basic_operations/get_campaigns.py -c INSERT_YOUR_CUSTOMER_ID_HERE
Дополнительные ресурсы
После того, как вы сможете отправлять запросы к API, перейдите к следующим примерам использования клиентской библиотеки: