Cos’è Google Cloud API Platform
Le API di Google Cloud possono essere accessibili da applicazioni server tramite le librerie client Google Cloud in una vasta gamma di linguaggi di programmazione noti, e anche da app mobili con gli SDK Firebase, o tramite client di terze parti. Tali soluzioni consentono diverse interazioni con i contenuti della piattaforma per gli utenti, ad esempio inserire le recensioni Google sul sito.
Tipi di API
Ci sono oltre 20 categorie di API nella libreria di Google. Discutiamone alcune.
- Maps APIs includono mappe nei siti web, fornendo immagini e dati locali da Google Maps. Gli utenti possono stilizzare le mappe per adattarle alle loro esigenze. Possono anche aiutare a ottenere dati dallo stesso database usato da Google Maps. Includono oltre 100 milioni di aziende e punti di interesse, aggiornati regolarmente.
- API di YouTube offrono accesso ai dati di YouTube – video, playlist e canali. Recuperano anche i dati analitici, pianificano lavori di reportistica contenenti tali dati e scaricano i rapporti di grandi dimensioni dai file CSV.
- Drive API permette agli utenti di creare app mobili, web e desktop in grado di leggere, scrivere e sincronizzare i file in Google Drive.
- Calendar API consente agli utenti di integrare le proprie app con Google Calendar, creando nuovi modi per coinvolgere il pubblico.
- Gmail API aiuta a visualizzare e gestire i dati della casella Gmail, ad esempio thread, messaggi ed etichette.
- Docs API viene utilizzata per leggere e scrivere documenti in modo programmatico, in modo da poter integrare i dati provenienti da diverse fonti sfruttando tutta la potenza di Google Docs.
- Sheets API aiuta gli utenti a leggere, scrivere e formattare i dati, oltre a creare chat in Google Sheets.
- API Social includono una serie di strumenti che permettono agli utenti di accedere alle informazioni sui profili e sui contatti di Google People, nonché di accedere ai post e ai commenti di un blog su Blogger.
- API pubblicitarie includono 12 API diverse che possono aiutare, ad esempio, gli editori AdSense ad accedere al loro inventario e generare report su guadagni e prestazioni.
- API mobili includono Fitness, Android e servizi Google Play. Consentono agli utenti di integrare facilmente funzionalità di gioco nelle loro app mobili, gestire i prodotti in-app e i dati di tracciamento dell’attività fisica degli utenti.
- Cloud APIs consentono agli utenti di automatizzare i propri flussi di lavoro utilizzando il linguaggio che preferiscono.
- Altri. Questa categoria di API comprende 62 opzioni, dall’accesso ai dati da parte del personale Google all’accorciamento degli URL.
Per ulteriori informazioni su ciascuna API fornita da Google consulta la Libreria API. Ora che hai scelto quelle che soddisfano le tue esigenze, procediamo al passaggio successivo.
Come lavorare con le API Cloud
La prima cosa necessaria per lavorare con le Cloud API è avere un account Google. Ti permette di accedere ai prodotti per sviluppatori Google, come la Cloud Console e Stackdriver Logging e Monitoring. Se non hai ancora un account Google, puoi iscriverti cliccando qui.
Passo 1. Crea un progetto Google
Per utilizzare qualsiasi API Cloud, devi avere un progetto Google equivalente a un account sviluppatore. Funziona come contenitore di risorse per Google Cloud Platform (GCP) e definisce un confine di isolamento per l’uso dei suoi servizi. Puoi creare il tuo progetto utilizzando la Cloud Console.
Il tuo progetto può gestire una vasta gamma di risorse, tra cui chiavi API, client OAuth, database BigQuery. Quando un’applicazione chiama un’API Cloud, il progetto che possiede le credenziali dell’app è chiamato progetto client, mentre il progetto che possiede la risorsa di destinazione è chiamato progetto risorsa. Inoltre, una singola richiesta API potrebbe toccare più risorse.
Passo 2. Abilita le API
Per l’utilizzo delle Cloud API, devi abilitarle nel tuo progetto o nei tuoi progetti (se ne hai più di uno). Per abilitare un’API devi accettare i Termini di Servizio e la responsabilità di fatturazione per l’API.
Per abilitare un’API, segui questi passaggi:
- Apri la Libreria API di Google Cloud Console.
- Seleziona un progetto dall’elenco dei progetti oppure creane uno nuovo.
- Nella libreria API, seleziona l’API che vuoi abilitare.
- Clicca su Abilita nella pagina API.
Hai sempre la possibilità di disabilitare un’API per il tuo progetto dalla stessa pagina se non la stai più usando. Le API Cloud possono anche essere abilitate o disabilitate tramite Cloud SDK e Service Usage API.
Alcune API Cloud richiedono pagamenti per l’uso. Per utilizzarle devi attivare la fatturazione per il tuo progetto. Clicca qui e segui le istruzioni per farlo.
Passo 3. Inizia a costruire applicazioni
Per costruire applicazioni sfruttando le API di Google Cloud, è consigliabile utilizzare le Google Cloud Client Libraries, se disponibili. Le Cloud Libraries gestiscono le funzionalità comuni delle API: autenticazione, gestione degli errori, retry e validazione del payload. <br><br>
Per far funzionare correttamente le applicazioni Google Cloud, gli utenti devono creare chiavi API. Vediamo come procedere.
Usare e ottenere le chiavi API
Una chiave API è una stringa crittografata semplice da utilizzare per richiamare determinate API che non richiedono l’accesso ai dati privati degli utenti. È una funzione utile in client come browser e applicazioni mobili che non dispongono di un backend.
Tutte le chiavi API hanno alcune limitazioni:
- Solo un numero limitato di servizi Google Cloud permette l’accesso con una chiave API, senza utilizzare un altro tipo di credenziale.
- Non puoi limitare l’accesso a utenti specifici o account di servizio, poiché la chiave API non identifica l’utente che effettua la richiesta API.
- È molto più facile per altri utilizzare la tua chiave API.
A causa delle limitazioni menzionate, Google raccomanda di utilizzare il flusso di autenticazione standard. Esistono però casi limitati in cui le chiavi API sono più indicate.
1. Crea la tua chiave API
Il tuo account deve essere assegnato al ruolo Editor nel progetto corrente affinché tu possa creare una chiave API.
- Vai al pannello API e servizi→Credenziali nella Cloud Console.
- Seleziona l’opzione Crea credenziali, quindi scegli CharKa API dal menu a discesa.
- La finestra di dialogo mostrerà la chiave appena creata.
2. Usa la tua chiave API
Per farlo, dovresti includere la chiave API in una chiamata REST API come parametro di query nel formato seguente. Sostituisci API_KEY qui con la tua chiave API:
Here’s an example of passing an API key for a Cloud Natural Language API request for documents.analyzeEntities:
3. Proteggi le chiavi API
Mantieni sempre al sicuro la chiave API. Segui queste buone pratiche per proteggerla:
- Non inserire mai le chiavi API direttamente nel codice, poiché potrebbero essere esposte pubblicamente per errore.
- Non conservare mai le chiavi API nei file del codice sorgente dell’app.
- Inizializza l’applicazione e imposta restrizioni sulla chiave. Questo può prevenire l’impatto di una chiave API compromessa.
- Non dimenticare di eliminare tutte le chiavi API non necessarie.
- Pagina delle credenziali.
- Verifica che il tuo codice non contenga chiavi API prima di distribuirlo.
Una volta assicurate le chiavi API, è il momento di applicare restrizioni.<br><br>
4. Aggiungi restrizioni alle chiavi API
Di default, tutte le chiavi API non hanno restrizioni. È necessario limitarle per impedirne l’accesso pubblico – ad esempio, da un browser o su un dispositivo dove la chiave è conservata.
Segui questi passaggi per impostare le restrizioni della chiave API:
- Vai alle API e servizi→Sezione Credenziali nella Cloud Console.
- Scegli il nome della chiave API esistente.
Puoi anche impostare restrizioni sull’applicazione. Queste specificano quali siti web, indirizzi IP o app possono utilizzare una chiave API.
È possibile impostare un solo tipo di restrizione per chiave API.
Ci sono cinque tipi di restrizioni tra cui scegliere in base alle esigenze della tua app:
- Nessuno può essere utilizzato solo per scopi di test.
- Riferimenti HTTP possono essere utilizzati da client API che girano in un browser.
- Indirizzi IP possono essere usati per limitare l’accesso alle chiavi API a determinati indirizzi IP.
- App Android è disponibile per le applicazioni Android.
- Le app iOS possono limitare le chiamate API a bundle iOS specifici.
Puoi trovare ulteriori informazioni sulle restrizioni API qui.
Prezzi e limiti di Google Cloud Platform
La piattaforma Google Cloud API offre molte opzioni di prezzo per ogni tipo di cliente. Puoi vederle tutte nella pagina Lista prezzi.
Ma c’è anche il Free Tier – garantisce utilizzo gratuito entro limiti mensili di prodotti selezionati, tra cui BigQuery e Compute Engine. Le opzioni gratuite di Google Cloud includono Cloud Functions, Storage e molte altre.
Ad esempio:
| Nome | Limiti |
| Google Calendar API | 1.000.000 richieste al giorno |
| Google Docs API | Gratuito |
| Gmail API | 1.000.000 unità di quota al giorno |
| Sheets API | 500 richieste ogni 100 secondi per progetto, 100 richieste ogni 100 secondi per utente |
Per vedere l’elenco completo delle opzioni, fai clic qui.
Per chi desidera conoscere i costi dei servizi a pagamento c’è un Calcolatore dei prezzi. Per usarlo, basta compilare tutti i campi vuoti e visualizzare i costi sui prodotti Google Cloud calcolati su misura per le tue esigenze.
FAQ (Domande frequenti)
Ci sono opzioni di supporto per l’API di Google Cloud?
Sì! Controlla la pagina di supporto per trovare le informazioni utili e ottenere i contatti del supporto.
Posso usare l’API di Google Cloud gratuitamente?
Puoi controllare la lista delle opzioni gratuite qui. Tieni presente che le prove gratuite finiscono quando esaurisci tutto il credito.
Posso eliminare il mio account Google Cloud API Console?
Assolutamente! Apri semplicemente il tuo account, poi controlla il pannello di navigazione a sinistra, fai clic su Dati e personalizzazione. Nella scheda Elimina il tuo account Google, scegli l’opzione Elimina.
Come posso passare a un piano a pagamento?
Devi farlo dopo la fine della prova gratuita. Apri Google Cloud Console e fai clic sul pulsante Attiva. Se il pulsante Attiva non è visibile, nella barra del menu fai clic su Stato della prova gratuita; apparirà il pulsante Attiva.
Conclusione
Ora sai come iniziare con Google API Platform. Saremo molto interessati a conoscere le tue esperienze con questo strumento. Condividi i tuoi casi d’uso e consigli utili nei commenti e non dimenticare di dirci se questa guida ti è stata utile!
