Come generare una chiave API per Google Translate

Pubblicato: 2019-03-06

Molti servizi esterni che utilizzano il cloud di Google richiedono una chiave API per funzionare. Ma cos'è una chiave API e come puoi ottenerne una? Questo è quello che sto per spiegarti adesso.

In questo articolo vedremo come ottenere una API Key per poter utilizzare Google Cloud Translate, ma il procedimento è lo stesso se vogliamo ottenere una API Key per un altro servizio Google Cloud, come Google Maps.

Cominciamo dall'inizio... Una chiave API non è altro che una stringa che usiamo come chiave di licenza per un particolare servizio. Nel nostro esempio, una chiave API di Google ci consentirà di accedere a qualsiasi servizio cloud di Google da un'applicazione esterna. Senza questa chiave non possiamo effettuare chiamate autenticate ai servizi Google Cloud da un'applicazione di terze parti, quindi l'applicazione che richiede questa chiave non funzionerà.

Ora che capiamo cos'è una chiave API, vediamo come ottenerne una per Google Translate.

Come creare un nuovo account in Google Cloud Console

La prima cosa di cui hai bisogno è un account in Google Cloud Console e un metodo di pagamento in esso. Per fare ciò, attenersi alla seguente procedura:

  • Accedi a Google Cloud Console ed effettua il login oppure, se non hai ancora un account, registrati.
  • Apri il menu a sinistra della console e seleziona Fatturazione .
  • Fare clic sul pulsante Nuovo account di fatturazione . Tieni presente che se questo non è il tuo primo account di fatturazione, devi prima aprire l'elenco degli account di fatturazione. Per fare ciò, fai clic sul nome del tuo account di fatturazione esistente nella parte superiore della pagina, quindi fai clic su Gestisci account di fatturazione .
  • Inserisci il nome dell'account di fatturazione e i tuoi dati di fatturazione. Le opzioni che vedrai dipendono dal Paese del tuo indirizzo di fatturazione.
  • Fai clic su Invia e abilita la fatturazione .
Schermata principale di Google Cloud Console.
Schermata principale di Google Cloud Console.

Per impostazione predefinita, la persona che crea l'account di fatturazione è un amministratore di fatturazione per l'account. Una volta creato l'account e pronti i dati di fatturazione, puoi continuare con i seguenti passaggi per ottenere la chiave API.

Come creare un nuovo progetto in Google Cloud

Vai alla barra nella parte superiore della finestra e nel menu a tendina puoi vedere i tuoi progetti creati oltre alla possibilità di crearne uno nuovo cliccando sul pulsante Nuovo Progetto :

Schermata di selezione e creazione del progetto in Google Cloud.
Schermata di selezione e creazione del progetto in Google Cloud.

Ora dai un nome al nuovo progetto e crealo facendo clic sul pulsante corrispondente, come puoi vedere nello screenshot seguente:

Visualizzazione di creazione di un nuovo progetto in Google Cloud.
Visualizzazione di creazione di un nuovo progetto in Google Cloud.

A questo punto dovresti già avere il progetto creato e selezionato, quindi andiamo avanti.

Attiva l'API di Google Translate

Prima di poter utilizzare un'API di Google nel tuo progetto, devi attivarla. Vai al menu laterale e seleziona l'opzione API e servizi :

Menu delle API e dei servizi di Google Cloud.
Menu delle API e dei servizi di Google Cloud.

Ora vedrai una schermata con le statistiche sulle API che hai attivato. Se hai creato il progetto da zero seguendo i passaggi precedenti, non avrai ancora alcun dato, come puoi vedere:

Dashboard delle API e dei servizi di Google Cloud.
Dashboard delle API e dei servizi di Google Cloud.

Fare clic sul pulsante in alto Abilita API e servizi per continuare con il processo di attivazione dell'API. Questo ci porta a una casella di ricerca in cui dobbiamo cercare l'API che ci interessa. In questo caso, vogliamo utilizzare l'API di Google Translate. Digita translate nella casella di ricerca e fai clic sul risultato Cloud Translate API :

Visualizzazione di ricerca API per l'attivazione successiva nel nostro progetto Google Cloud.
Visualizzazione di ricerca API per l'attivazione successiva nel nostro progetto Google Cloud.

Questo ci porta a una schermata con la descrizione dell'API Cloud Translation. Fare clic sul pulsante Abilita per attivare l'API nel nostro progetto:

Prima di poter iniziare a utilizzare l'API di Google Translate nel nostro progetto, devi attivarla in Google Cloud.
Prima di poter iniziare a utilizzare l'API di Google Translate nel nostro progetto, devi attivarla in Google Cloud.

Abbiamo già attivato l'API di Google Cloud Translation. Ci siamo quasi…

Crea una nuova chiave API per Google Translate

Dopo aver attivato l'API, vediamo come generare una nuova Key API per poter utilizzare questo servizio. Dobbiamo tornare al menu laterale e selezionare l'opzione Credenziali :

Menu di gestione delle credenziali di Google Cloud Translate.
Menu di gestione delle credenziali di Google Cloud Translate.

In questa schermata vediamo un pulsante con un menu a tendina e il testo Crea credenziali . Non fare clic sul pulsante! Invece, apri il menu a discesa facendo clic sulla freccia a destra del pulsante e seleziona l'opzione Chiave API .

Devi selezionare il tipo di credenziale Key API per creare una nuova chiave per l'API di Google Translate.
Devi selezionare le credenziali della chiave API per creare una nuova chiave per l'API di Google Translate.

Questo crea la nuova API chiave. Puoi copiarlo se vuoi, anche se puoi accedervi in ​​seguito:

Google Cloud ci fornisce una nuova API chiave per utilizzare Google Translate con le nostre applicazioni di terze parti.
Google Cloud ci fornisce una nuova API chiave per utilizzare Google Translate con le nostre applicazioni di terze parti.

Come limitare la nostra chiave API per proteggerne e limitarne l'uso

Per controllare il costo di Google Cloud utilizzando l'API di Google Cloud Translation (o Google Translate, che è lo stesso), possiamo fare due cose: limitare dove puoi utilizzare la chiave API che abbiamo appena creato o limitare la quota consentita da utilizzare il servizio stesso.

Nello screenshot sopra, se fai clic sul pulsante Restrict Key , andrai alla schermata di restrizione della chiave API che segue:

Possiamo limitare da quale dominio web possiamo utilizzare l'API della chiave che abbiamo appena generato per evitare un uso improprio in caso di perdita.
Possiamo limitare da quale dominio web possiamo utilizzare la chiave API che abbiamo appena generato.

Lì puoi selezionare di limitare la chiave API tramite referrer HTTP , il che significa che puoi effettuare chiamate all'API di Google Cloud Translate solo utilizzando la chiave API da determinati nomi di dominio.

È necessario aggiungere i nomi di dominio validi nella casella di testo visualizzata quando si seleziona l'opzione referrer HTTP . Nel nostro caso, abbiamo aggiunto qui il nostro nome di dominio https://neliosoftware.com/* .

D'altra parte, vai al menu API e serviziDashboardCloud Translation APIQuote e lì troverai una casella chiamata Caratteri . Lì puoi modificare i limiti di quota dell'API di Google Cloud Translation e ridurli, se necessario.

Il prezzo per l'API di Google Cloud Translation al momento della stesura di questo post è di 20 USD per milione di caratteri tradotti, quindi fai i tuoi numeri.

Google Cloud ci consente di limitare l'uso che facciamo delle API per controllare il consumo massimo che vogliamo finire per pagare.
Google Cloud ci consente di limitare l'uso delle API per controllare il costo massimo che vogliamo finire per pagare.

E questo è tutto! Hai già la tua chiave API pronta per essere utilizzata con l'applicazione che desideri. Il processo è un po' macchinoso all'inizio, ma seguendo i passaggi otterrai la chiave API senza problemi. Provalo e fammi sapere se hai bisogno di ulteriore assistenza!

Immagine in primo piano di Conor Luddy su Unsplash.