Клиентская библиотека Python размещена на GitHub, а пакет доступен в PyPI.
Требования
Библиотека поддерживает Python 3.9–3.14 (>=3.9, <3.15; поддержка Python 3.14 была добавлена в v28.2.0). Поскольку Python 3.9 и 3.10 при импорте в google-ads v32.0.0 и более поздних версиях выдают предупреждение об устаревании, рекомендуется использовать Python 3.11 или более позднюю версию.
Требования
Прежде чем следовать инструкциям в этом руководстве, вам понадобится десятизначный идентификатор клиента аккаунта Google Рекламы.
Совместимость со средой выполнения и зависимостями
Клиентская библиотека Python совместима с версиями среды выполнения Python, перечисленными в разделе Поддерживаемые версии, опубликованном Python Software Foundation, за исключением версий со статусом "feature" или "prerelease".
Команда Google Рекламы API стремится внедрять новые версии среды выполнения Python сразу после их выпуска и официальной поддержки фондом Python Software Foundation.
Среды выполнения Python, срок поддержки которых истек, не поддерживаются после даты окончания срока поддержки, указанной в разделе Unsupported Versions на сайте python.org. Совместимость с версиями среды выполнения, для которых прекращена поддержка, не гарантируется, поскольку выпуски библиотеки после даты прекращения поддержки могут нарушить совместимость.
Для зависимостей (в частности, для всех пакетов, поддерживаемых Google и указанных как обязательные в клиентской библиотеке Python) совместимость поддерживается с пакетами, которые поддерживаются Google и считаются "поддерживаемыми" в соответствии с правилами Google в отношении критических изменений в ПО с открытым исходным кодом.
Полный список поддерживаемых сред выполнения Python и зависимостей приведен на странице Зависимости.
Установка
В руководстве по установке описаны все способы установки библиотеки. Самый простой (и рекомендуемый) способ установить библиотеку в приложение – использовать pip:
python -m pip install google-ads
Конфигурация
После установки библиотеки необходимо задать ее конфигурацию. Существует несколько способов настроить библиотеку, которые описаны в руководстве по настройке.
Аутентификация
После того как вы выбрали подход к конфигурации, настройте аутентификацию. Пошаговые инструкции приведены в руководстве по аутентификации клиентской библиотеки Python. Общую информацию можно найти в обзоре OAuth.
Как отправить запрос к API
После того как вы настроите аутентификацию, можно будет отправлять запросы к API. Чтобы быстро проверить, правильно ли настроена библиотека для отправки запросов API, воспользуйтесь примером get campaigns.
Чтобы запустить пример get_campaigns.py, сначала клонируйте репозиторий google-ads-python. Затем в корневом каталоге клонированного репозитория выполните следующую команду:
python examples/basic_operations/get_campaigns.py -c INSERT_CUSTOMER_ID_HERE
Дополнительные ресурсы
После того как вы сможете отправлять запросы к API, перейдите к следующим разделам, чтобы узнать, как использовать клиентскую библиотеку: