Antes de empezar a programar tu primera aplicación cliente, tienes que llevar a cabo varias tareas (si aún no lo has hecho):
Obtener una cuenta de Google
Para crear un proyecto en la consola de APIs de Google, necesitas una cuenta de Google. Si ya la tienes, puedes ponerte manos a la obra.
También es recomendable tener otra cuenta de Google distinta con la que puedas hacer pruebas.
Crear un proyecto para el cliente
Para poder enviar solicitudes a la API de búsqueda de Gráfico de Conocimiento de Google, primero debes informar a Google sobre tu cliente y activar el acceso a la API. Para ello, ve a la consola de APIs de Google y crea un proyecto, que es un modo de agrupar ajustes e información de acceso a la API bajo un mismo nombre. Luego, registra tu aplicación.
Para empezar a usar la API de búsqueda de Google Knowledge Graph, primero debes utilizar la herramienta de configuración, que te guiará por los pasos necesarios para crear un proyecto en la consola de APIs de Google y habilitar la API.
Si aún no lo has hecho, crea la clave de API de tu aplicación haciendo clic en Crear credenciales > Clave de API. A continuación, busca tu clave de API en la sección Claves de API.
Información básica sobre REST
Hay dos formas de invocar la API:
- Enviar peticiones HTTP y analizar las respuestas.
- Utilizar bibliotecas cliente.
Si prefieres no utilizar las bibliotecas cliente, tendrás que comprender los aspectos básicos de REST.
REST es un estilo de arquitectura de software que permite solicitar y modificar datos de un modo cómodo y coherente.
El término REST es la abreviatura en inglés de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, hace referencia al uso de verbos HTTP para obtener y modificar representaciones de datos almacenados por Google.
En un sistema RESTful, los recursos se guardan en un almacén de datos; un cliente envía una solicitud para que el servidor realice una determinada acción (como crear, obtener, actualizar o eliminar un recurso) y el servidor lleva a cabo la acción y envía una respuesta, normalmente como una representación del recurso especificado.
En las API de Google en las que se utiliza REST, el cliente especifica una acción mediante un verbo HTTP, como POST, GET, PUT o DELETE. Especifica un recurso mediante un identificador URI exclusivo global con el siguiente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Como todos los recursos de la API tienen URIs únicos accesibles mediante HTTP, REST permite almacenar los datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.
Pueden resultarte útiles las definiciones de métodos de la documentación del estándar HTTP 1.1, ya que incluyen las especificaciones de GET, POST, PUT y DELETE.
REST en la API de búsqueda de Google Knowledge Graph
Las operaciones de la API de Google Knowledge Graph Search se asignan directamente a los verbos HTTP de REST.
El formato específico para los URIs de la API Google Knowledge Graph Search es:
https://kgsearch.googleapis.com/v1/entities:search?query=your_query¶meters
En el documento de referencia de la API Search de Google Knowledge Graph se resume el conjunto completo de los URIs que se utilizan para cada operación admitida en la API.
Información básica sobre JSON
La API de búsqueda de Gráfico de Conocimiento de Google devuelve datos en formato JSON.
JSON (JavaScript Object Notation, Notación de objetos JavaScript) es un formato de datos común e independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarios. Para obtener más información, accede a la página json.org.