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 chiamarle utilizzando i comandi curl. Puoi utilizzare i comandi curl per fare esperimenti con un'API prima di sviluppare l'applicazione.

Creare 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 conosci 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 Google Cloud servizi, in modo da poter gestire i limiti di quota e la fatturazione 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ò possedere una vasta gamma di risorse, tra cui chiavi API, client OAuth, account di servizio, VM 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 e il progetto che possiede la risorsa di destinazione è chiamato progetto risorsa. Una richiesta API può coinvolgere più risorse, quindi sono coinvolti più progetti di risorse.

Se per qualsiasi motivo non vuoi più utilizzare Google Cloud, puoi utilizzare la 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.

Scoprire le 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 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 attivata per impostazione predefinita, devi attivarla per il tuo progetto. A seconda dei servizi e dei progetti coinvolti nella tua applicazione, inclusi il progetto client e i progetti di risorse, potrebbe essere necessario attivare un'API per più progetti. Quando attivi un'API che dipende da altre API, queste vengono attivate contemporaneamente.

Per abilitare un'API devi accettare i Termini di servizio e la responsabilità per la fatturazione 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 attivare un'API per un progetto tramite 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. 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 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

Per alcune API Cloud è previsto un costo per l'utilizzo. Devi abilitare 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 della console Google Cloud e segui le istruzioni per crearne uno. Poi, collega il tuo account di fatturazione al tuo 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 è consigliato 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, devi creare un ID client OAuth 2.0 e utilizzare le librerie di autenticazione.

Per informazioni generali sull'autenticazione, consulta Autenticazione su 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. 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 alle librerie client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate alle API per conto della tua applicazione.Google Cloud

Consulta le seguenti guide passo passo che utilizzano le librerie client per alcune API di uso comune:

Per ulteriori informazioni, consulta Librerie client spiegate.

Ulteriori informazioni