Per iniziare

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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 con un'API prima di sviluppare l'applicazione.

Creare un Account Google

Per utilizzare le API Google Cloud nelle tue applicazioni, devi innanzitutto 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.

Creare un progetto Google

Per utilizzare le API Cloud, devi anche avere un progetto Google. Un progetto equivale a un account sviluppatore. Serve come container 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 sull'utilizzo vengono raggruppate per progetto. Se non hai ancora un progetto, puoi crearne uno utilizzando la console Google Cloud.

Un progetto può possedere un'ampia gamma di risorse, tra cui chiavi API, client OAuth, account di servizio, VM di 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, mentre il progetto che possiede la risorsa di destinazione è chiamato progetto di risorsa. Una richiesta API può toccare più risorse, quindi sono coinvolti più progetti di risorse.

Se vuoi smettere di utilizzare Google Cloud per qualsiasi motivo, puoi usare la console Google Cloud per eliminare il progetto. Il progetto e tutte le risorse che contiene verranno eliminati dopo la finestra di conservazione. Tieni presente che i diversi tipi di dati hanno periodi di conservazione differenti.

Alla scoperta delle API

Prima di utilizzare le API Cloud, devi usare la libreria API della console Google Cloud per sfogliare le API Cloud disponibili e scoprire quelle più adatte alle tue esigenze aziendali. 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…

Per utilizzare un'API Cloud, devi abilitarla per il tuo progetto. A seconda dei servizi e dei progetti coinvolti dalla tua applicazione, inclusi il progetto client e i progetti di risorse, potrebbe essere necessario abilitare un'API per più progetti.

Per abilitare un'API, devi accettare i Termini di servizio e la responsabilità di fatturazione dell'API. Per abilitare le API devi avere l'autorizzazione serviceusage.services.enable nel progetto. Per ulteriori informazioni, consulta la pagina sull'utilizzo del servizio Controllo accesso.

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

  1. Vai alla libreria API della console Google Cloud.
  2. Nell'elenco dei progetti, seleziona quello che vuoi 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.

Dalla stessa pagina puoi disattivare un'API per il tuo progetto se non la utilizzi più per evitare usi illeciti e addebiti involontari della fatturazione. 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 vengono addebitate in base all'utilizzo. Devi attivare 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 di Google Cloud Console e segui le istruzioni per crearne uno. Quindi, collega l'account di fatturazione al tuo progetto.

Recupero credenziali applicazione

Le API Cloud accettano solo richieste API da applicazioni registrate. Questo requisito aiuta i produttori di API ad associare e segnalare l'utilizzo dell'API al progetto giusto proprietario dell'applicazione.

Le API Cloud utilizzano le credenziali per le applicazioni per identificare le applicazioni di chiamata. I tipi di credenziali includono chiavi API, client OAuth 2.0 e account di servizio. Puoi utilizzare la console Google Cloud per creare, recuperare e gestire le credenziali dell'applicazione. Per ulteriori informazioni sulle credenziali dell'applicazione, consulta Panoramica dell'autenticazione.

Creazione di applicazioni

Se stai creando un'applicazione utilizzando le API Cloud, ti consigliamo di utilizzare le librerie client di Google Cloud, se disponibili. Le librerie client possono gestire le comuni funzionalità delle API per tua comodità, come autenticazione, gestione degli errori, nuovi tentativi e convalida del payload. Devi trasmettere le tue credenziali dell'applicazione alle librerie client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate alle API Google Cloud per conto della tua applicazione.

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

Per ulteriori informazioni, consulta la sezione Spiegazione delle librerie client.

Informazioni dettagliate

Per scoprire di più sull'autenticazione, consulta la pagina Panoramica dell'autenticazione.

Per maggiori informazioni sulla gestione degli errori, consulta la sezione Gestire gli errori.

Per maggiori informazioni sulla fatturazione, consulta Creare, modificare o chiudere l'account di fatturazione.

Per ulteriori informazioni sull'abilitazione della fatturazione per il progetto, consulta Modificare le impostazioni di fatturazione di un progetto.

Per ulteriori informazioni sull'attivazione e la disattivazione delle API, vedi Attivazione e disattivazione dei servizi.