Questa pagina spiega come gli sviluppatori possono iniziare a utilizzare le API Google Cloud.
Se utilizzi le API Google Cloud per la prima volta, puoi seguire i passaggi di questa guida per chiamare le API utilizzando i comandi curl
. Puoi utilizzare i comandi curl
per sperimentare con un'API prima di sviluppare l'applicazione.
Creare un Account Google
Per utilizzare le API Google Cloud nelle tue applicazioni, devi innanzitutto avere un Account Google. In questo modo puoi utilizzare i prodotti per sviluppatori Google, tra cui Google Cloud Console, gcloud CLI, Cloud Logging e Cloud Monitoring. Se non hai mai utilizzato Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono inoltre 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Creare un progetto Google
Per utilizzare le API Cloud, devi anche avere un progetto Google. Un progetto equivale a un account sviluppatore. Serve come container per le tue risorse Google Cloud. Fornisce inoltre un limite di isolamento per l'utilizzo dei servizi Google Cloud, in modo da poter gestire i limiti di quota e la fatturazione in modo indipendente a livello di progetto. Anche la telemetria e le dashboard sull'utilizzo vengono raggruppate per progetto. Se non hai ancora un progetto, puoi crearne uno utilizzando la console Google Cloud.
Un progetto può possedere un'ampia gamma di risorse, tra cui chiavi API, client OAuth, account di servizio, VM di Compute Engine, bucket Cloud Storage e set di dati BigQuery. Quando un'applicazione chiama un'API Cloud, il progetto che possiede le credenziali dell'applicazione è chiamato progetto client, mentre il progetto che possiede la risorsa di destinazione è chiamato progetto di risorsa. Una richiesta API può toccare più risorse, quindi sono coinvolti più progetti di risorse.
Se vuoi smettere di utilizzare Google Cloud per qualsiasi motivo, puoi usare la console Google Cloud per eliminare il progetto. Il progetto e tutte le risorse che contiene verranno eliminati dopo la finestra di conservazione. Tieni presente che i diversi tipi di dati hanno periodi di conservazione differenti.
Alla scoperta delle API
Prima di utilizzare le API Cloud, devi usare la libreria API della console Google Cloud per sfogliare le API Cloud disponibili e scoprire quelle più adatte alle tue esigenze aziendali. Per ulteriori informazioni su un'API Cloud specifica, visita il relativo sito di documentazione pubblico, ad esempio l'API Spanner.
Abilitazione delle API in corso…
Alcune API Cloud sono abilitate per impostazione predefinita. Per utilizzare un'API Cloud non abilitata per impostazione predefinita, devi abilitarla per il tuo progetto. A seconda dei servizi e dei progetti coinvolti dalla tua applicazione, inclusi il progetto client e i progetti di risorse, potrebbe essere necessario abilitare un'API per più progetti. Quando abiliti un'API che dipende da altre API, vengono abilitate contemporaneamente anche queste.
Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità di fatturazione dell'API. Per abilitare le API devi avere l'autorizzazione serviceusage.services.enable
nel progetto. Per ulteriori informazioni, consulta la pagina sull'utilizzo del servizio Controllo accesso.
Inoltre, il servizio da abilitare deve essere pubblico, altrimenti il proprietario del servizio deve concedere all'utente l'autorizzazione servicemanagement.services.bind
per il servizio privato. Per ulteriori informazioni, consulta la pagina Controllo dell'accesso a Service Management.
Per abilitare un'API per un progetto utilizzando la console:
- Vai alla libreria API della console Google Cloud.
- Nell'elenco dei progetti, seleziona quello che vuoi utilizzare.
- Nella libreria API, seleziona l'API che vuoi attivare. Se hai bisogno di aiuto per trovare l'API, utilizza il campo di ricerca e/o i filtri.
- Nella pagina dell'API, fai clic su ABILITA.
Dalla stessa pagina puoi disattivare un'API per il tuo progetto se non la utilizzi più per evitare usi illeciti e addebiti involontari della fatturazione. Puoi anche abilitare e disabilitare le API Cloud utilizzando gcloud CLI e l'API Service Usage:
$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com
Abilitazione della fatturazione in corso
Alcune API Cloud vengono addebitate in base all'utilizzo. Devi attivare la fatturazione per il progetto prima di poter iniziare a utilizzare queste API nel progetto. L'utilizzo dell'API in un progetto viene addebitato all'account di fatturazione associato al progetto.
Se non hai un account di fatturazione, vai alla pagina di fatturazione di Google Cloud Console e segui le istruzioni per crearne uno. Quindi, collega l'account di fatturazione al tuo progetto.
Autenticazione alle API
La modalità di autenticazione a un'API dipende dall'ambiente di sviluppo e dai metodi di autenticazione supportati dall'API.
La configurazione di Credenziali predefinite dell'applicazione per l'utilizzo in diversi ambienti è l'approccio più comune ed è consigliata per la maggior parte delle applicazioni. Se l'API supporta le chiavi API, questa è un'altra opzione. Se la tua applicazione deve accedere alle risorse Cloud di proprietà dei tuoi utenti finali, crea un ID client OAuth 2.0 e utilizza le librerie di autenticazione.
Per informazioni generali sull'autenticazione, consulta Autenticazione presso Google.
Creazione di applicazioni
Se stai creando un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie client di Google Cloud, se disponibili. Le librerie client possono gestire le comuni funzionalità delle API per tua comodità, come autenticazione, gestione degli errori, nuovi tentativi e convalida del payload. Devi trasmettere le tue credenziali dell'applicazione alle librerie client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate alle API Google Cloud per conto della tua applicazione.
Consulta le seguenti guide passo passo che utilizzano le librerie client per alcune API popolari:
- API Cloud Billing Budget con Node.js.
- API Cloud Billing Budget con Python.
- Cloud Logging con Node.js
- Cloud Logging con Python
- Cloud Logging con Go
- Cloud Logging con Java
- Speech-to-Text con Node.js.
- Speech-to-Text con Python.
- Speech-to-Text con Go.
- Speech-to-Text con Java.
Per ulteriori informazioni, consulta la sezione Spiegazione delle librerie client.
Informazioni dettagliate
Per ulteriori informazioni sull'autenticazione, consulta Autenticazione presso Google.
Per maggiori informazioni sulla gestione degli errori, consulta la sezione Gestire gli errori.
Per maggiori informazioni sulla fatturazione, consulta Creare, modificare o chiudere l'account di fatturazione.
Per ulteriori informazioni sull'abilitazione della fatturazione per il progetto, consulta Modificare le impostazioni di fatturazione di un progetto.
Per ulteriori informazioni sull'attivazione e la disattivazione delle API, vedi Attivazione e disattivazione dei servizi.