Клиентская библиотека Python размещена на GitHub, а пакет доступен на PyPI.
Требования
Библиотека поддерживает Python версий 3.9–3.14 (>=3.9, <3.15; поддержка Python 3.14 добавлена в v28.2.0). Поскольку при импорте в google-ads v32.0.0 и более поздних версиях Python 3.9 и 3.10 выдают предупреждение об устаревании, рекомендуется использовать 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, перейдите к следующим вариантам использования клиентской библиотеки: