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