Требования

Прежде чем приступить к разработке своего первого клиентского приложения, вам необходимо выполнить несколько действий, если вы еще этого не сделали.

Зарегистрируйте аккаунт Google

Для создания проекта в консоли Google API вам потребуется учетная запись Google . Если у вас уже есть учетная запись, то все в порядке.

Для целей тестирования вам также может понадобиться отдельный аккаунт Google.

Создайте проект для своего клиента.

Прежде чем отправлять запросы к Google Knowledge Graph Search API, необходимо сообщить Google о вашем клиенте и активировать доступ к API. Для этого с помощью консоли Google API создайте проект , представляющий собой именованный набор настроек и информации о доступе к API, и зарегистрируйте свое приложение.

Для начала работы с Google Knowledge Graph Search API необходимо сначала воспользоваться инструментом настройки , который поможет вам создать проект в консоли Google API и включить API.

Если вы еще этого не сделали, создайте ключ API для своего приложения, нажав «Создать учетные данные» > «Ключ API» . Затем найдите свой ключ API в разделе «Ключи API» .

Изучите основы REST.

Существует два способа вызова API:

Если вы решите не использовать клиентские библиотеки, вам потребуется понять основы REST.

REST — это стиль программной архитектуры, обеспечивающий удобный и согласованный подход к запросу и изменению данных.

Термин REST расшифровывается как « Representational State Transfer» (передача репрезентативного состояния ). В контексте API Google это означает использование HTTP-глаголов для получения и изменения представлений данных, хранящихся в Google.

В RESTful-системе ресурсы хранятся в хранилище данных; клиент отправляет запрос серверу на выполнение определенного действия (например, создание, получение, обновление или удаление ресурса), а сервер выполняет действие и отправляет ответ, часто в виде представления указанного ресурса.

В RESTful API от Google клиент указывает действие, используя HTTP-глагол, такой как POST , GET , PUT или DELETE . Он указывает ресурс с помощью глобально уникального URI следующего вида:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Поскольку все ресурсы API имеют уникальные URI, доступные по протоколу HTTP, REST обеспечивает кэширование данных и оптимизирован для работы с распределенной инфраструктурой сети.

Возможно, вам пригодятся определения методов в документации по стандартам HTTP 1.1; они включают спецификации для GET , POST , PUT и DELETE .

REST в API поиска Google Knowledge Graph

Операции API поиска Google Knowledge Graph напрямую соответствуют HTTP-глаголам REST.

Конкретные форматы URI для API поиска Google Knowledge Graph следующие:

https://kgsearch.googleapis.com/v1/entities:search?query=your_query&parameters

Полный набор URI, используемых для каждой поддерживаемой операции в API, приведен в справочном документе Google Knowledge Graph Search API .

Изучите основы JSON.

API поиска Google Knowledge Graph возвращает данные в формате JSON.

JSON (JavaScript Object Notation) — это распространённый, независимый от языка формат данных, предоставляющий простое текстовое представление произвольных структур данных. Для получения дополнительной информации см. json.org .