Per iniziare

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

Creazione di un Account Google

Per utilizzare le API Google Cloud nelle tue applicazioni, devi prima avere un Account Google. In questo modo puoi usare i prodotti per sviluppatori Google, tra cui: Console Google Cloud, 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. Nuovi clienti ricevi anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Creazione di un progetto Google

Per usare le API Cloud, devi anche avere un progetto Google. Un progetto è equivalente a un account sviluppatore. Funge da container di risorse le tue risorse Google Cloud. Fornisce inoltre un confine di isolamento Utilizzo dei servizi Google Cloud per gestire i limiti di quota e la fatturazione in modo indipendente a livello di progetto. La telemetria di utilizzo e le dashboard sono raggruppate per progetti. Se non hai ancora un progetto, puoi crearne uno mediante la console Google Cloud.

Un progetto può essere proprietario di un'ampia gamma di risorse, tra cui chiavi API, client OAuth account di servizio, VM di Compute Engine, bucket Cloud Storage e BigQuery e set di dati. Quando l'applicazione chiama un'API Cloud, il progetto proprietario dell'applicazione per le credenziali si chiama progetto client e il progetto proprietario la risorsa di destinazione è denominata progetto di risorsa. Una richiesta API può riguardare sono coinvolti più risorse.

Se vuoi interrompere l'utilizzo di Google Cloud per qualsiasi motivo, puoi usare Console Google Cloud per eliminare il progetto. Il tuo il progetto e tutte le sue risorse saranno eliminati dopo il periodo di conservazione finestra. Tieni presente che tipi diversi di dati hanno periodi di conservazione differenti.

scoperta delle API

Prima di utilizzare qualsiasi API Cloud, utilizza la console Google Cloud libreria API per sfoglia le API Cloud disponibili e scopri quelle più adatte alla tua attività e alle esigenze aziendali. Per ulteriori informazioni su una specifica API Cloud, visita la relativa API di documentazione, come 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 abilitarlo per il tuo progetto. In base a quale e quali progetti sono coinvolti dalla tua applicazione, tra cui progetti client e di risorse, potrebbe essere necessario abilitare un'API più progetti. Quando abiliti un'API che dipende da altre API, queste API sono attivate contemporaneamente.

Per abilitare un'API devi accettare i Termini di servizio e la responsabilità della fatturazione per l'API. Devi avere l'autorizzazione serviceusage.services.enable del progetto per abilitare le API. Per ulteriori informazioni, consulta Controllo dell'accesso in Service Usage.

Inoltre, il servizio da abilitare deve essere pubblico oppure il proprietario deve concedere all'utente l'autorizzazione servicemanagement.services.bind su il servizio privato. Per ulteriori informazioni, vedi Controllo dell'accesso di Service Management informazioni.

Per attivare un'API per un progetto tramite la console:

  1. Vai alla sezione 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 abilitare. Per ulteriore assistenza trovare l'API, utilizzare 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 Usalo per evitare addebiti involontari o l'uso improprio. 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

Alcune API Cloud prevedono addebiti per l'utilizzo. Devi abilitare la fatturazione per il tuo progetto prima di poter iniziare a utilizzare queste API nel tuo 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 a Pagina di fatturazione della console Google Cloud e segui le istruzioni per crearne uno. Poi collegare l'account di fatturazione al tuo progetto.

Autenticazione nelle API

La modalità di autenticazione in un'API dipende dall'ambiente di sviluppo e da metodi di autenticazione supportati dall'API.

Configurare le credenziali predefinite dell'applicazione per l'utilizzo in una vasta gamma di ambienti è l'approccio più comune ed è consigliato per la maggior parte diverse 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, crea un ID client OAuth 2.0 e utilizza le librerie di autenticazione.

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

Creazione di applicazioni

Se stai creando un'applicazione con le API Cloud, ti consigliamo di usare Librerie client di Google Cloud se disponibili. Le librerie client possono gestire funzionalità API comuni per i tuoi come autenticazione, gestione degli errori, nuovi tentativi e payload dei dati. Devi passare le credenziali dell'applicazione alle librerie client durante l'inizializzazione, in modo che le librerie client possano effettuare chiamate alle API Google Cloud per conto dell'applicazione.

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

Per ulteriori informazioni, vedi Spiegazione delle librerie client.

Ulteriori informazioni