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 di questa guida per chiamare le API utilizzando i comandi curl. Puoi utilizzare i comandi curl per sperimentare un'API prima di sviluppare l'applicazione.

Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

Creazione di un progetto Google

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 . Un progetto equivale a un account sviluppatore. Funge da contenitore 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. Anche la telemetria e le dashboard di utilizzo sono raggruppate per progetti. Se non hai ancora un progetto, puoi crearne uno utilizzando la consoleGoogle Cloud .

Un progetto può essere proprietario di un'ampia gamma di risorse, tra cui chiavi API, client OAuth, service account, VM 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 risorsa. Se una richiesta API tocca più risorse, sono coinvolti più progetti di risorse.

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

Individuare le 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 più adatte alle tue esigenze aziendali.

Abilitazione delle API in corso…

Alcune Google Cloud API sono abilitate per impostazione predefinita. Per utilizzare un'API Google Cloud che 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 di risorse, potrebbe essere necessario abilitare un'API per più progetti. Quando abiliti un'API che dipende da altre API, 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 per il progetto. Per saperne di più, consulta la sezione Controllo dell'accesso di Service Usage .

Inoltre, il servizio da attivare deve essere pubblico oppure il proprietario del servizio deve concedere all'utente l'autorizzazione servicemanagement.services.bind sul servizio privato. Per saperne di più, consulta Controllo dell'accesso alla gestione dei servizi.

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

  1. Vai alla libreria API della consoleGoogle 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 i filtri.
  4. Nella pagina dell'API, fai clic su ABILITA.

Dalla stessa pagina puoi disattivare 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 l'utilizzo. Prima di poter iniziare a utilizzare queste API nel tuo progetto, 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 e segui le istruzioni per crearne uno.Google Cloud Poi collega il tuo account di fatturazione al tuo progetto.

Autenticazione nelle 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 serie 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, devi creare un ID client OAuth 2.0 e utilizzare le librerie di autenticazione.

Per informazioni generali sull'autenticazione, vedi Autenticazione su Google.

Creazione di applicazioni

Se stai creando un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie clientGoogle Cloud , se disponibili. Per comodità, le librerie client possono gestire le funzionalità API comuni, come autenticazione, gestione degli errori, tentativi e convalida del payload. Devi trasmettere 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.

Consulta le seguenti guide passo passo che utilizzano le librerie client per alcune API popolari:

Per saperne di più, vedi Spiegazione delle librerie client.

Ulteriori informazioni