Per iniziare

Questa pagina spiega in che modo gli sviluppatori possono iniziare a utilizzare le API Google Cloud.

Se è la prima volta che utilizzi le API Google Cloud, puoi seguire i passaggi riportati in questa guida per chiamare le API utilizzando i comandi curl. Puoi usare i comandi curl per sperimentare con un'API prima di sviluppare l'applicazione.

Creazione di un Account Google

Per utilizzare le API Google Cloud nelle tue applicazioni, devi prima avere un Account Google. In questo modo puoi utilizzare i prodotti per sviluppatori Google, tra cui 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 è equivalente a un account sviluppatore. Funge da container di risorse per le tue risorse Google Cloud. Fornisce inoltre un confine di isolamento per l'utilizzo dei servizi Google Cloud, consentendoti di gestire i limiti di quota e la fatturazione in modo indipendente a livello di progetto. Anche la telemetria e le dashboard di utilizzo sono raggruppate per progetto. Se non hai ancora un progetto, puoi crearne uno utilizzando la console Google Cloud.

Un progetto può disporre di 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 proprietario delle credenziali dell'applicazione è denominato progetto client, mentre quello a cui appartiene la risorsa di destinazione è denominato progetto di risorsa. Una richiesta API può riguardare più risorse, quindi sono coinvolti più progetti di risorse.

Se vuoi interrompere l'utilizzo di Google Cloud per qualsiasi motivo, puoi utilizzare la console Google Cloud per eliminare il progetto. Il progetto e tutte le risorse al suo interno verranno eliminati dopo il periodo di conservazione. Tieni presente che i vari tipi di dati hanno periodi di conservazione differenti.

Alla scoperta delle API

Prima di utilizzare qualsiasi API Cloud, ti consigliamo di 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 della 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 nell'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, anche queste vengono abilitate contemporaneamente.

Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità di fatturazione per l'API. Per abilitare le API devi disporre dell'autorizzazione serviceusage.services.enable nel progetto. Per ulteriori informazioni, vedi Controllo degli accessi di Service Usage.

Inoltre, il servizio da abilitare deve essere pubblico oppure il proprietario del servizio deve concedere all'utente l'autorizzazione servicemanagement.services.bind per il servizio privato. Per ulteriori informazioni, vedi Controllo dell'accesso di Service Management.

Per abilitare un'API per un progetto utilizzando la console:

  1. Vai alla libreria API della console Google Cloud.
  2. Dall'elenco dei progetti, seleziona quello che vuoi utilizzare.
  3. 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.
  4. Nella pagina dell'API, fai clic su ABILITA.

Nella stessa pagina puoi disabilitare un'API per il tuo progetto se non la utilizzi più per evitare usi impropri e addebiti di fatturazione 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 addebitano un costo per l'utilizzo. Prima di poter iniziare a utilizzare queste API devi abilitare la fatturazione per il 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 nelle API

La modalità di autenticazione in un'API dipende dall'ambiente di sviluppo e dai metodi di autenticazione supportati dall'API.

La configurazione delle 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, si tratta di 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 Autenticazione su Google.

Creazione di applicazioni

Se crei un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie client di Google Cloud, se disponibili. Le librerie client possono gestire comodamente le funzionalità delle API comuni, come l'autenticazione, la gestione degli errori, i nuovi tentativi e la convalida del payload. Devi passare le 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:

Per ulteriori informazioni, consulta la sezione Spiegazione sulle librerie client.

Informazioni dettagliate