- Google API Client
- Version 2.0 Release
- Documentation
- Other Google API libraries
- Installation
- Mac/Linux
- Windows
- Supported Python Versions
- Unsupported Python Versions
- Third Party Libraries and Dependencies
- Contributing
- Установка клиентских библиотек
- Go
- Java
- Как добавить клиентскую библиотеку в проект
- JavaScript
- .NET
- Как скачать библиотеку
- Node.js
- Obj-C
- PHP
- Python
- Системные требования
- Как установить клиентскую библиотеку
- Установка с помощью менеджера пакетов
- Установка вручную
- App Engine
- Ruby
- Как установить гем google-api-client
- Как начать работу с клиентской библиотекой API Google для Ruby
- Другие способы обращения к Indexing API
- Установка клиентских библиотек
- Go
- Java
- Как добавить клиентскую библиотеку в проект
- JavaScript
- .NET
- Как скачать библиотеку
- Node.js
- Obj-C
- PHP
- Python
- Системные требования
- Как установить клиентскую библиотеку
- Установка с помощью менеджера пакетов
- Установка вручную
- App Engine
- Ruby
- Как установить гем google-api-client
- Как начать работу с клиентской библиотекой API Google для Ruby
- Другие способы обращения к Indexing API
- Монтаж
- Установите модуль из PyPI
- Установите библиотеку с GitHub
Google API Client
This is the Google API Python client library for Google’s discovery based APIs. To get started, please see the docs folder.
This library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.
This library is officially supported by Google. However, the maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development. For more information, please visit Client Libraries Explained.
Version 2.0 Release
The 2.0 release of google-api-python-client includes a substantial reliability improvement, compared with 1.x, as discovery documents are now cached in the library rather than fetched dynamically. It is highly recommended to upgrade from v1.x to v2.x.
Only python 3.7 and newer is supported. If you are not able to upgrade python, then please continue to use version 1.x as we will continue supporting python 2.7+ in v1.
Discovery documents will no longer be retrieved dynamically when you call discovery.build() . The discovery documents will instead be retrieved from the client library directly. New versions of this library are released weekly. As a result of caching the discovery documents, the size of this package is at least 50 MB larger compared to the previous version.
Please see the Migration Guide for more information.
Documentation
See the docs folder for more detailed instructions and additional documentation.
Other Google API libraries
The maintainers of this repository recommend using Cloud Client Libraries for Python, where possible, for new code development due to the following reasons:
- There is a separate client library for each API, so you can choose which client libraries to download. Whereas, google-api-python-client is a single client library for all APIs. As a result, the total package size for google-api-python-client exceeds 50MB.
- There are stricter controls for breaking changes to the underlying APIs as each client library is focused on a specific API.
- There are more features in these Cloud Client Libraries as each library is focused on a specific API, and in some cases, the libraries are owned by team who specialized in that API.
- Developers will benefit from intellisense.
For more information, please visit Client Libraries Explained.
Although there are many benefits to moving to Cloud Client Libraries for Python, the maintainers want to emphasize that google-api-python-client will continue to be supported.
For Google Ads API, we recommend using Google Ads API Client Library for Python.
For Google Firebase Admin API, we recommend using Firebase Admin Python SDK.
Installation
Install this library in a virtualenv using pip. virtualenv is a tool to create isolated Python environments. The basic problem it addresses is one of dependencies and versions, and indirectly permissions.
With virtualenv, it’s possible to install this library without needing system install permissions, and without clashing with the installed system dependencies.
Mac/Linux
pip3 install virtualenv virtualenv source /bin/activate /bin/pip install google-api-python-client
Windows
pip install virtualenv virtualenv \Scripts\activate \Scripts\pip.exe install google-api-python-client
Supported Python Versions
Python 3.7, 3.8, 3.9, 3.10 and 3.11 are fully supported and tested. This library may work on later versions of 3, but we do not currently run tests against those versions.
Unsupported Python Versions
Third Party Libraries and Dependencies
The following libraries will be installed when you install the client library:
For development you will also need the following libraries:
Contributing
Please see our Contribution Guide. In particular, we love pull requests — but please make sure to sign the contributor license agreement.
Установка клиентских библиотек
В Indexing API используются технологии HTTP и JSON, поэтому для отправки запросов и обработки ответов подходит любой стандартный HTTP-клиент.
Однако мы рекомендуем работать с клиентскими библиотеками API Google, поскольку они обеспечивают более высокий уровень безопасности, поддержку запросов, требующих авторизации, и более эффективную интеграцию языков. С клиентскими библиотеками вам больше не придется вручную настраивать HTTP-запросы и интерпретировать ответы.
Сначала выберите язык программирования, на котором вы пишете код.
Go
Java
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Java. Более подробная информация приведена в следующей документации:
Как добавить клиентскую библиотеку в проект
Выберите среду сборки (Maven или Gradle).
Добавьте в файл pom.xml следующий код:
Посмотрите все доступные версии в центральном репозитории Maven.
Добавьте в файл build.gradle следующий код:
Посмотрите все доступные версии в центральном репозитории Maven.
JavaScript
Прочитайте руководство к этой библиотеке.
.NET
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для .NET. Более подробная информация приведена в следующей документации:
Как скачать библиотеку
Установите пакет NuGet, доступный по этой ссылке: Google.Apis.
Node.js
Obj-C
PHP
Python
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Python. Более подробная информация приведена в следующей документации:
Системные требования
Как установить клиентскую библиотеку
Вы можете воспользоваться менеджером пакетов или скачать и установить клиентскую библиотеку для Python вручную:
Установка с помощью менеджера пакетов
Для управления установкой используйте pip или setuptools. Возможно, сначала потребуется запустить sudo .
pip install --upgrade google-api-python-client
easy_install --upgrade google-api-python-client
Установка вручную
App Engine
Так как клиентские библиотеки для Python не установлены в среде выполнения Python сервиса App Engine, их необходимо скопировать в приложение тем же способом, что и другие сторонние библиотеки.
Ruby
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Ruby. Более подробная информация приведена в следующей документации:
Как установить гем google-api-client
В некоторых системах перед этими командами нужно добавлять элемент sudo .
Если вы не устанавливали клиентскую библиотеку API Google для Ruby, сделайте это с помощью RubyGems :
gem install google-api-client
Если у вас уже установлен этот гем, обновите его до последней версии с помощью следующей команды:
gem update -y google-api-client
Как начать работу с клиентской библиотекой API Google для Ruby
Информацию о том, как создать первый запрос, можно найти в кратком руководстве по началу работы.
Другие способы обращения к Indexing API
Другие способы обращения к Indexing API приведены в следующей таблице:
Метод обращения | Описание |
---|---|
API Explorer | Интерактивный инструмент, позволяющий опробовать API Google прямо в браузере. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-02-22 UTC.
Установка клиентских библиотек
В Indexing API используются технологии HTTP и JSON, поэтому для отправки запросов и обработки ответов подходит любой стандартный HTTP-клиент.
Однако мы рекомендуем работать с клиентскими библиотеками API Google, поскольку они обеспечивают более высокий уровень безопасности, поддержку запросов, требующих авторизации, и более эффективную интеграцию языков. С клиентскими библиотеками вам больше не придется вручную настраивать HTTP-запросы и интерпретировать ответы.
Сначала выберите язык программирования, на котором вы пишете код.
Go
Java
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Java. Более подробная информация приведена в следующей документации:
Как добавить клиентскую библиотеку в проект
Выберите среду сборки (Maven или Gradle).
Добавьте в файл pom.xml следующий код:
Посмотрите все доступные версии в центральном репозитории Maven.
Добавьте в файл build.gradle следующий код:
Посмотрите все доступные версии в центральном репозитории Maven.
JavaScript
Прочитайте руководство к этой библиотеке.
.NET
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для .NET. Более подробная информация приведена в следующей документации:
Как скачать библиотеку
Установите пакет NuGet, доступный по этой ссылке: Google.Apis.
Node.js
Obj-C
PHP
Python
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Python. Более подробная информация приведена в следующей документации:
Системные требования
Как установить клиентскую библиотеку
Вы можете воспользоваться менеджером пакетов или скачать и установить клиентскую библиотеку для Python вручную:
Установка с помощью менеджера пакетов
Для управления установкой используйте pip или setuptools. Возможно, сначала потребуется запустить sudo .
pip install --upgrade google-api-python-client
easy_install --upgrade google-api-python-client
Установка вручную
App Engine
Так как клиентские библиотеки для Python не установлены в среде выполнения Python сервиса App Engine, их необходимо скопировать в приложение тем же способом, что и другие сторонние библиотеки.
Ruby
На этой странице рассказано о том, как начать работу с Indexing API, используя клиентскую библиотеку API Google для Ruby. Более подробная информация приведена в следующей документации:
Как установить гем google-api-client
В некоторых системах перед этими командами нужно добавлять элемент sudo .
Если вы не устанавливали клиентскую библиотеку API Google для Ruby, сделайте это с помощью RubyGems :
gem install google-api-client
Если у вас уже установлен этот гем, обновите его до последней версии с помощью следующей команды:
gem update -y google-api-client
Как начать работу с клиентской библиотекой API Google для Ruby
Информацию о том, как создать первый запрос, можно найти в кратком руководстве по началу работы.
Другие способы обращения к Indexing API
Другие способы обращения к Indexing API приведены в следующей таблице:
Метод обращения | Описание |
---|---|
API Explorer | Интерактивный инструмент, позволяющий опробовать API Google прямо в браузере. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-02-22 UTC.
Монтаж
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Независимо от того, устанавливаете ли вы библиотеку из PyPI или клонируете ее из GitHub, мы рекомендуем вам выполнить следующие шаги, используя активную виртуальную среду. Сведения о том, как создать и активировать виртуальную среду, см. в документации по виртуальной среде .
Установите модуль из PyPI
Библиотека распространяется на PyPI и может быть легко установлена с помощью pip . Просто запустите следующую команду:
python -m pip install google-ads
Установите библиотеку с GitHub
Исходный код библиотеки можно клонировать с GitHub на локальный компьютер. Полезно клонировать исходный код, чтобы легко выполнять примеры или разрабатывать саму библиотеку. Для справки: запуск одного из примеров проверки подлинности является обязательным шагом при настройке библиотеки для использования.
- Убедитесь, что в вашей среде присутствует python3.6 или выше. Самый простой способ — использовать pyenv :
git clone git@github.com:googleads/google-ads-python.git
cd google-ads-python
python -m pip install .
- Убедитесь, что в вашей среде доступны как python3.6 , так и python3.7 . Используя pyenv , как упоминалось выше:
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons «С указанием авторства 4.0», а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2023-07-11 UTC.