google api python client

API-клиент Google

Это клиентская библиотека Google API Python для API-интерфейсов Google, основанных на обнаружении. Чтобы начать, просмотрите папку документации.

Эта библиотека считается завершенной и находится в режиме обслуживания. Это означает, что мы исправим критические ошибки и проблемы безопасности, но не будем добавлять никаких новых функций.

Эта библиотека официально поддерживается Google. Однако сопровождающие этого репозитория рекомендуют по возможности использовать облачные клиентские библиотеки для Python для разработки нового кода. Для получения дополнительной информации посетите страницу «Объяснение клиентских библиотек».

Выпуск версии 2.0

Версия 2.0 google-api-python-client включает существенное повышение надежности по сравнению с версией 1.x, поскольку документы обнаружения теперь кэшируются в библиотеке, а не извлекаются динамически. Настоятельно рекомендуется выполнить обновление с версии 1.x до версии 2.x.

Поддерживается только Python 3.7 и новее. Если вы не можете обновить Python, продолжайте использовать версию 1.x, поскольку мы продолжим поддерживать Python 2.7+ в версии 1.

Документы обнаружения больше не будут извлекаться динамически при вызове метода discovery.build() . Вместо этого документы обнаружения будут получены напрямую из клиентской библиотеки. Новые версии этой библиотеки выпускаются еженедельно. В результате кэширования документов обнаружения размер этого пакета увеличился как минимум на 50 МБ по сравнению с предыдущей версией.

Дополнительную информацию см. в Руководстве по миграции.

Документация

Более подробные инструкции и дополнительную документацию см. в папке docs.

Другие библиотеки Google API

Сопровождающие этого репозитория рекомендуют использовать облачные клиентские библиотеки для Python, где это возможно, для разработки нового кода по следующим причинам:

С облачными клиентскими библиотеками для Python:

• Для каждого API существует отдельная клиентская библиотека, поэтому вы можете выбрать, какие клиентские библиотеки загружать. Принимая во внимание, что google-api-python-client — это единая клиентская библиотека для всех API. В результате общий размер пакета для google-api-python-client превышает 50 МБ.
• Существуют более строгие меры контроля за внесением изменений в базовые API, поскольку каждая клиентская библиотека ориентирована на определенный API.
• В этих облачных клиентских библиотеках есть больше функций, поскольку каждая библиотека ориентирована на определенный API, а в некоторых случаях библиотеки принадлежат команде, специализирующейся на этом API.
• Разработчики выиграют от IntelliSense.

Для получения дополнительной информации посетите страницу «Объяснение клиентских библиотек».

Хотя переход на облачные клиентские библиотеки для Python имеет множество преимуществ, разработчики хотят подчеркнуть, что поддержка google-api-python-client будет продолжаться.

Для API Google Рекламы мы рекомендуем использовать клиентскую библиотеку API Google Рекламы для Python.

Для API администратора Google Firebase мы рекомендуем использовать Firebase Admin Python SDK.

Установка

Установите эту библиотеку в виртуальную среду с помощью pip. virtualenv — это инструмент для создания изолированных сред Python. Основная проблема, которую он решает, — это проблемы зависимостей и версий, а также косвенно разрешений.

С помощью virtualenv можно установить эту библиотеку, не требуя разрешений на установку системы и не конфликтуя с установленными системными зависимостями.

Мак/Линукс

pip3 install virtualenv
virtualenv < your-env >
source < your-env > /bin/activate
< your-env > /bin/pip install google-api-python-client

Окна

pip install virtualenv
virtualenv < your-env >
< your-env > Scriptsactivate
< your-env > Scriptspip.exe install google-api-python-client

Поддерживаемые версии Python

Python 3.7, 3.8, 3.9, 3.10, 3.11 и 3.12 полностью поддерживаются и протестированы. Эта библиотека может работать с более поздними версиями 3, но в настоящее время мы не проводим тесты для этих версий.

Неподдерживаемые версии Python

Питон < 3,7

Сторонние библиотеки и зависимости

При установке клиентской библиотеки будут установлены следующие библиотеки:

• httplib2
• шаблон мочевого пузыря

Для разработки вам также понадобятся следующие библиотеки:

• Веб-тест
• pyopenssl

Содействие

Пожалуйста, ознакомьтесь с нашим Руководством по вкладам. В частности, мы любим запросы на включение, но, пожалуйста, не забудьте подписать лицензионное соглашение для участников.