Prima di poter iniziare la codifica della tua prima applicazione client, è necessario eseguire alcune operazioni, qualora non lo avessi già fatto.
Crea un account Google
È necessario un Account Google per creare un progetto nella console API di Google. Se hai già un account, non devi fare altro.
Inoltre, potresti utilizzare un Account Google separato a scopo di test.
Creare un progetto per il client
Prima di poter inviare richieste all'API di ricerca di Google Knowledge Graph, devi informare Google del tuo client e attivare l'accesso all'API. A tale scopo, utilizza la console API di Google per creare un progetto, ovvero una raccolta denominata di impostazioni e informazioni relative all'accesso all'API, e registra la tua applicazione.
Per iniziare a utilizzare l'API Google Knowledge Graph Search, devi innanzitutto utilizzare lo strumento di configurazione, che ti aiuterà a creare un progetto nella console API di Google, attivare l'API e creare le credenziali.
Se non lo hai già fatto, crea la chiave API dell'applicazione facendo clic su Crea credenziali > Chiave API. Cerca la chiave API nella sezione Chiavi API.
Apprendere le nozioni di base di REST
Esistono due modi per richiamare l'API:
- Inviare richieste HTTP e analizzarne le risposte.
- Utilizzare le librerie client.
Se decidi di non utilizzare le librerie client, è necessario che tu conosca le nozioni di base di REST.
REST è un tipo di architettura software che fornisce un approccio pratico e coerente per la richiesta e la modifica dei dati.
Il termine REST è l'acronimo di "REpresentational State Transfer". Nel contesto delle API di Google, si riferisce all'utilizzo dei verbi HTTP per recuperare e modificare le rappresentazioni dei dati archiviati da Google.
In un sistema RESTful, le risorse vengono archiviate in un datastore. Un client invia una richiesta affinché il server esegua una determinata azione (ad esempio la creazione, il recupero, l'aggiornamento o l'eliminazione di una risorsa) e il server esegue l'azione e invia una risposta, spesso sotto forma di rappresentazione della risorsa specificata.
Nelle API RESTful di Google, il client specifica un'azione utilizzando un verbo HTTP come POST, GET, PUT o DELETE. Specifica una risorsa mediante un URI univoco a livello globale nel seguente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Poiché tutte le risorse dell'API dispongono di URI univoci accessibili tramite HTTP, REST consente la memorizzazione dei dati nella cache ed è ottimizzato per operare con l'infrastruttura distribuita del Web.
Potresti trovare utili le definizioni dei metodi nella documentazione degli standard HTTP 1.1, in cui sono incluse le specifiche per GET, POST, PUT e DELETE.
REST nell'API Google Knowledge Graph
Le operazioni dell'API Google Knowledge Graph Search vengono mappate direttamente ai verbi HTTP REST.
I formati specifici per gli URI dell'API Search di Google Knowledge Graph sono:
https://kgsearch.googleapis.com/v1/entities:search?query=your_query¶meters
L'insieme completo di URI utilizzati per ogni operazione supportata nell'API è riepilogato nel documento Google Knowledge Graph Search API Reference.
Apprendere le nozioni di base di JSON
L'API Google Knowledge Graph Search restituisce i dati in formato JSON.
JSON (JavaScript Object Notation) è un formato dati comune indipendente dal linguaggio che fornisce una semplice rappresentazione testuale delle strutture dati arbitrarie. Per ulteriori informazioni, visita il sito json.org.