Guida introduttiva

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 descritti in questa guida per chiamare le API utilizzando i comandi curl. Puoi utilizzare i comandi curl per fare esperimenti 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 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.

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 contenitore di risorse per le tue risorse Google Cloud. Fornisce inoltre un confine 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 relative all'utilizzo vengono raggruppate per progetti. Se non hai ancora un progetto, puoi crearne uno utilizzando la console Google Cloud.

Un progetto può essere proprietario di un'ampia gamma di risorse, tra cui chiavi API, client OAuth account di servizio, VM di Compute Engine, bucket Cloud Storage e BigQuery e dei set di dati. Quando un'applicazione chiama un'API Cloud, il progetto che possiede le credenziali dell'applicazione è chiamato progetto client e il progetto che possiede la risorsa di destinazione è chiamato progetto risorsa. Una richiesta API può riguardare sono coinvolti più risorse.

Se per qualsiasi motivo vuoi interrompere l'utilizzo di Google Cloud, puoi usare Console Google Cloud per eliminare il progetto. Il progetto e tutte le risorse al suo interno verranno eliminati al termine del periodo di conservazione. Tieni presente che i periodi di conservazione sono diversi a seconda del tipo di dati.

Alla scoperta delle API

Prima di utilizzare qualsiasi API Cloud, devi utilizzare la libreria API della console Google Cloud per sfogliare le API Cloud disponibili e scoprire quelle che soddisfano al meglio le esigenze della tua attività. Per ulteriori informazioni su una specifica API Cloud, visita la relativa di documentazione, come 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 attivarla per il tuo progetto. In base a quale e quali progetti sono coinvolti dalla tua applicazione, tra cui progetti client e di risorse, potrebbe essere necessario abilitare un'API più progetti. Quando abiliti un'API che dipende da altre API, queste API sono attivate contemporaneamente.

Per abilitare un'API, devi accettare i Termini di servizio e la fatturazione responsabile dell'API. Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable nel progetto. Per ulteriori informazioni, consulta Controllo dell'accesso in Service Usage.

Inoltre, il servizio da attivare deve essere pubblico oppure il proprietario del servizio deve concedere all'utente l'autorizzazione servicemanagement.services.bind per il servizio privato. Per ulteriori informazioni, consulta Controllo dell'accesso per la gestione dei servizi.

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 il progetto da utilizzare.
  3. Nella libreria API, seleziona l'API che vuoi attivare. Per ulteriore assistenza trovare l'API, utilizzare 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 accidentali. Puoi anche attivare e disattivare 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 prevedono un addebito per l'utilizzo. Devi abilitare la fatturazione per il tuo progetto puoi iniziare a usare queste API nel tuo progetto. L'utilizzo dell'API in un Il progetto viene addebitato all'account di fatturazione associato al progetto.

Se non hai un account di fatturazione, vai a Pagina di fatturazione della console Google Cloud e segui le istruzioni per crearne uno. Poi, collega il tuo 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.

Configurare le credenziali predefinite dell'applicazione per l'utilizzo in una vasta gamma di ambienti è l'approccio più comune ed è consigliato per la maggior parte diverse 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 su Google.

Creazione di applicazioni

Se stai creando un'applicazione con le API Cloud, ti consigliamo di usare Librerie client di Google Cloud se disponibili. Per comodità, le librerie client possono gestire funzionalità API comuni, come autenticazione, gestione degli errori, riprova e convalida del payload. Devi passare le credenziali dell'applicazione al client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate le API Google Cloud per conto della tua applicazione.

Consulta le seguenti guide passo passo che utilizzano le librerie client per alcuni le API più diffuse:

Per ulteriori informazioni, consulta Librerie client spiegate.

Ulteriori informazioni