Questa pagina spiega come gli sviluppatori possono iniziare a utilizzare le API Google Cloud.
Se è la prima volta che utilizzi le API Google Cloud, puoi seguire i passaggi descritti in questa guida per chiamare le API utilizzando i comandi curl
. Puoi utilizzare i comandi curl
per sperimentare con un'API prima di sviluppare la tua applicazione.
Creare un Account Google
Per utilizzare le API Google Cloud nelle tue applicazioni, devi prima avere un Account Google. Ciò ti consente di utilizzare i prodotti per sviluppatori Google, tra cui la console Google Cloud, 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 anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Creazione di un progetto Google
Per utilizzare le API Cloud, devi anche avere un progetto Google. Un progetto equivale a un account sviluppatore. Viene utilizzato come container di risorse 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. La telemetria e le dashboard sull'utilizzo vengono raggruppate anche per progetti. Se non hai ancora un progetto, puoi crearne uno utilizzando la console Google Cloud.
Un progetto può possedere una vasta 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 proprietario delle credenziali dell'applicazione è chiamato progetto client, mentre il progetto proprietario della risorsa target è chiamato progetto di risorsa. Una richiesta API può toccare più risorse, quindi sono coinvolti più progetti di risorse.
Se per qualsiasi motivo vuoi smettere di utilizzare Google Cloud, puoi usare la console Google Cloud. 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 qualsiasi API Cloud, dovresti usare la libreria API della console Google Cloud per sfogliare le API Cloud disponibili e scoprire quelle che meglio soddisfano le esigenze della tua azienda. Per ulteriori informazioni su un'API Cloud specifica, visita il relativo sito di documentazione pubblica, 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. Se abiliti un'API che dipende da altre API, anche queste vengono abilitate contemporaneamente.
Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità
della fatturazione per l'API. Devi avere l'autorizzazione serviceusage.services.enable
sul progetto per abilitare le API. Per ulteriori informazioni, consulta Service Usage
Controllo dell'accesso.
Inoltre, il servizio da abilitare deve essere pubblico; in caso contrario, il proprietario del servizio deve concedere all'utente l'autorizzazione servicemanagement.services.bind
sul servizio privato. Per ulteriori informazioni, consulta Service Management Access Control.
Per abilitare un'API per un progetto che utilizza la console:
- Vai alla libreria API della console Google Cloud.
- Dall'elenco dei progetti, seleziona il progetto che vuoi utilizzare.
- Nella libreria API, seleziona l'API che vuoi abilitare. 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 usi più per evitare usi impropri e addebiti accidentali. 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 per l'utilizzo. Devi abilitare la fatturazione per il tuo 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 della console Google Cloud e segui le istruzioni per crearne uno. Quindi, collega l'account di fatturazione al progetto.
Autenticazione alle API
La modalità di autenticazione a un'API dipende dal tuo ambiente di sviluppo e dai metodi di autenticazione supportati dall'API.
La configurazione delle credenziali predefinite delle applicazioni in diversi ambienti è l'approccio più comune ed è consigliata per la maggior parte delle applicazioni. Se l'API supporta le chiavi API, rappresenta un'altra opzione. Se la tua applicazione deve accedere alle risorse Cloud di proprietà dei tuoi utenti finali, puoi creare un ID client OAuth 2.0 e utilizzare le librerie di autenticazione.
Per informazioni generali sull'autenticazione, consulta la pagina relativa all'autenticazione in 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 funzionalità comuni dell'API per comodità, come l'autenticazione, la gestione degli errori, i nuovi tentativi e la convalida del payload. Durante l'inizializzazione devi passare le credenziali dell'applicazione alle librerie client, 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 saperne di più, consulta la sezione Spiegazione delle librerie client.
Informazioni dettagliate
Per scoprire di più sull'autenticazione, consulta la pagina relativa all'autenticazione in Google.
Per maggiori informazioni sulla gestione degli errori, vedi Gestione degli errori.
Per ulteriori informazioni sulla fatturazione, consulta Creare, modificare o chiudere l'account di fatturazione.
Per ulteriori informazioni sull'abilitazione della fatturazione per il tuo progetto, consulta Modificare le impostazioni di fatturazione di un progetto.
Per ulteriori informazioni sull'attivazione e la disattivazione delle API, consulta Attivazione e disattivazione dei servizi.