Требования

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

Получить аккаунт Google

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

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

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

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

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

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

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

Есть два способа вызвать API:

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

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

Термин REST является сокращением от « Передача представительского состояния ». В контексте 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) — это распространенный, независимый от языка формат данных, который обеспечивает простое текстовое представление произвольных структур данных. Для получения дополнительной информации посетите json.org .