Клиентская библиотека 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 Ads 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, перейдите к следующим вариантам использования клиентской библиотеки: