Autorizzare le richieste

Quando la tua applicazione richiede dati pubblici, questa non deve essere autorizzata, ma deve essere accompagnata da un identificatore, ad esempio una chiave API.

La tua applicazione deve identificarsi ogni volta che invia una richiesta all'API Google Knowledge Graph Search, includendo una chiave API con ogni richiesta.

Acquisire e utilizzare una chiave API

Per acquisire una chiave API:

  1. Apri la pagina Credenziali nella console API.
  2. Questa API supporta due tipi di credenziali. Crea le credenziali appropriate per il tuo progetto:
    • OAuth 2.0: ogni volta che la tua applicazione richiede dati utente privati, deve inviare un token OAuth 2.0 insieme alla richiesta. L'applicazione invia prima un ID client e possibilmente un client secret per ottenere un token. Puoi generare le credenziali OAuth 2.0 per applicazioni web, account di servizio o applicazioni installate.

      Nota: poiché questa API non ha metodi che richiedono l'autorizzazione OAuth 2.0, potresti dover ottenere solo le chiavi API, descritte di seguito. Tuttavia, se l'applicazione chiama altre API che richiedono l'autorizzazione dell'utente, sono comunque necessarie le credenziali OAuth 2.0.

      Per ulteriori informazioni, consulta la documentazione di OAuth 2.0.

    • Chiavi API: una richiesta che non fornisce un token OAuth 2.0 deve inviare una chiave API. La chiave identifica il progetto e fornisce accesso alle API, quota e report.

      L'API supporta diversi tipi di restrizioni sulle chiavi API. Se la chiave API necessaria non esiste già, crea una chiave API nella console facendo clic su Crea credenziali > Chiave API. Puoi limitare la chiave prima di utilizzarla in produzione facendo clic su Limita chiave e selezionando una delle restrizioni.

Per proteggere le tue chiavi API, segui le best practice per l'utilizzo sicuro delle chiavi API.

Dopo aver creato una chiave API, l'applicazione può aggiungere il parametro di ricerca key=yourAPIKey a tutti gli URL della richiesta.

La chiave API è sicura per l'incorporamento negli URL e non richiede alcuna codifica.