Guida introduttiva

Questa pagina spiega come gli sviluppatori possono iniziare a utilizzare le Google Cloud API.

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 consoleGoogle 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 proprietario delle credenziali dell'applicazione è chiamato progetto client e il progetto proprietario della 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 consoleGoogle 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 per i vari tipi di dati.

Scoprire le API

Prima di utilizzare qualsiasi API Cloud, devi utilizzare la Google Cloud libreria API della console per sfogliare le API Cloud disponibili e scoprire quelle che soddisfano al meglio le esigenze della tua attività. Per saperne di più 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 abilitata 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 abilitare 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à della fatturazione per l'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 consoleGoogle 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 disattivare 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 Google Cloud pagina di fatturazione della console 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 vari 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