Клиентская библиотека Python размещена на GitHub , а пакет доступен на PyPI .
В версии 10.0.0 клиентской библиотеки представлен ряд изменений интерфейса, которые мы задокументировали в разделе «Библиотека версии 10.0.0» .
Требования
Для библиотеки требуется Python 3.8 или новее.
Предварительные условия
Перед установкой библиотеки вам понадобится токен разработчика и идентификатор клиента клиента. Инструкции о том, как их получить, изложены в разделе «Предварительные требования» . Обратите внимание, что другие необходимые токены OAuth2 вы создадите на последующих шагах.
Установка
Следуйте инструкциям в нашей документации по установке , чтобы установить библиотеку из PyPi и вернуться на эту страницу.
Конфигурация
После установки библиотеки вам нужно будет настроить для нее конфигурацию. Существует несколько способов настройки библиотеки, которые описаны в нашей документации по настройке .
Аутентификация
После того, как вы выбрали тип конфигурации, вы можете приступить к генерации оставшихся токенов OAuth2, необходимых для отправки запросов к API. Существует несколько поддерживаемых потоков OAuth2, которые описаны в списке ниже. Подробную информацию о различиях между потоками и помощь в принятии решения о том, какой из них лучше всего подходит для вашего приложения, см. в нашей документации по OAuth .
Делаем запрос API
После того как вы включили токены OAuth2 в свою конфигурацию, вы готовы сделать запрос API. Обратитесь к примеру получения кампаний , чтобы узнать простой способ проверить, правильно ли настроена библиотека для выполнения запросов API.
Чтобы запустить образец get_campaigns.py , в корневом каталоге локально установленной клиентской библиотеки googleads-python выполните следующую команду:
$ python examples/basic_operations/get_campaigns.py -c \
INSERT_YOUR_CUSTOMER_ID_HERE
Дополнительные ресурсы
После того, как вы сможете сделать запрос API, перейдите к следующему использованию клиентской библиотеки: