Guida introduttiva

La configurazione di un progetto Google Cloud e dell'autenticazione ti consente di chiamare le API Google Cloud dalle tue applicazioni. In questo documento, imparerai a utilizzare le API Google Cloud creando un progetto, scoprendo e abilitando i servizi nella libreria API, collegando un account di fatturazione, configurando le credenziali ed esplorando le librerie client.

Creazione di un progetto Google Cloud

Per utilizzare le API Google Cloud , devi disporre di un account utente (un accountGoogle o un account di un provider di identità esterno) e di un progettoGoogle Cloud . Un progetto equivale a un account sviluppatore. Funge da container di risorse per le tue risorse Google Cloud . Inoltre, fornisce 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 di utilizzo sono raggruppate per progetto. Se non hai ancora un progetto, puoi crearne uno utilizzando la consoleGoogle Cloud .

Un progetto può possedere un'ampia gamma di risorse, tra cui chiavi API, client OAuth, service account, VM di Compute Engine, bucket Cloud Storage e set di dati BigQuery. Quando un'applicazione chiama un'API Google Cloud , il progetto proprietario delle credenziali dell'applicazione è chiamato progetto client, mentre il progetto proprietario della risorsa di destinazione è chiamato progetto della risorsa. Alcune richieste API possono interessare più risorse, nel qual caso nella richiesta può essere coinvolto più di un progetto di risorse.

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

Scoperta delle API

Prima di utilizzare qualsiasi API Google Cloud , devi utilizzare la Libreria API della console Google Cloud per sfogliare le APIGoogle Cloud disponibili e scoprire quelle che meglio soddisfano le tue esigenze aziendali.

Abilitazione delle API in corso…

Alcune API Google Cloud sono abilitate per impostazione predefinita. Per utilizzare un'API Google Cloud non abilitata per impostazione predefinita, devi abilitarla per il tuo progetto. A seconda dei servizi e dei progetti coinvolti nella tua applicazione, inclusi il progetto client e i progetti delle risorse, potrebbe essere necessario abilitare un'API per più progetti. Quando abiliti un'API che dipende da altre API, anche queste ultime vengono abilitate contemporaneamente.

Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità di fatturazione per l'API. Devi disporre dell'autorizzazione serviceusage.services.enable sul progetto per abilitare le API.

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

  1. Vai alla libreria API della consoleGoogle Cloud .
  2. Dall'elenco dei progetti, seleziona il progetto 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 i filtri.
  4. Nella pagina dell'API, fai clic su ABILITA.

Dalla stessa pagina puoi disabilitare un'API per il tuo progetto se non la utilizzi 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 addebitano costi per l'utilizzo. Devi abilitare la fatturazione per il tuo progetto prima di poter iniziare a utilizzare queste API. L'utilizzo dell'API in un progetto viene addebitato all'account di fatturazione associato al 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 delle Credenziali predefinite dell'applicazione per l'utilizzo in una varietà di 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à degli utenti finali, crea un ID client OAuth 2.0 e utilizza le librerie di autenticazione.

Per informazioni generali sull'autenticazione, consulta Autenticazione in Google.

Creazione di applicazioni

Se stai creando un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie clientGoogle Cloud , se disponibili. Le librerie client possono gestire le funzionalità API comuni per tua comodità, 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 APIGoogle Cloud per conto della tua applicazione.

Ulteriori informazioni