Le librerie client semplificano l'accesso alle API Google Cloud da un linguaggio supportato. Puoi utilizzare le API Google Cloud direttamente inviando richieste non elaborate al server, ma le librerie client offrono semplificazioni che riducono notevolmente la quantità di codice da scrivere.
Questo documento illustra i diversi tipi di librerie client forniti da Google per le API Cloud. Puoi anche trovare ulteriori informazioni sulle librerie disponibili per il tuo prodotto o il linguaggio preferito nella documentazione del prodotto o della lingua.
Librerie client cloud
Le librerie client Cloud sono l'opzione consigliata per accedere in modo programmatico alle API Cloud, se disponibile. Le librerie client di Cloud utilizzano il modello di libreria client più recente e:
- Fornisci codice idiomatico in ogni linguaggio per rendere le API Cloud semplici e intuitive.
- Fornisci uno stile coerente tra le librerie client per semplificare il lavoro con più servizi Cloud.
- Gestire tutti i dettagli di basso livello della comunicazione con il server, inclusa l'autenticazione su Google.
- Può essere installato utilizzando strumenti di gestione dei pacchetti familiari come
npmepip. - In alcuni casi, puoi ottenere vantaggi in termini di prestazioni utilizzando gRPC. Per ulteriori informazioni, consulta le API gRPC.
Puoi trovare le istruzioni di installazione e il materiale di riferimento per la libreria client Cloud nella pagina Librerie client delle API Cloud che stai utilizzando. Puoi trovare i link per iniziare a utilizzare le librerie client di Cloud e la relativa documentazione di riferimento nella pagina Librerie client di Cloud.
Provalo
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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Inizia gratuitamenteLibrerie client delle API di Google
Alcune API Google Cloud non dispongono di librerie client Cloud in tutti i linguaggi. Se vuoi utilizzare una di queste API e non è disponibile una libreria client Cloud per il tuo linguaggio preferito, puoi comunque utilizzare lo stile precedente di libreria client, chiamato librerie client delle API di Google. Puoi utilizzare queste librerie anche se esegui l'upgrade di un progetto che le utilizza già. Queste librerie:
- Fornisce l'accesso solo all'interfaccia REST dell'API. gRPC non è supportato.
- Avere un codice di interfaccia generato automaticamente che potrebbe non essere idiomatico come le librerie client di Cloud.
- Gestire tutti i dettagli di basso livello della comunicazione con il server, inclusa l'autenticazione su Google.
- Può essere installato utilizzando strumenti di gestione dei pacchetti familiari come
npmepip.
I link a queste librerie sono disponibili nella pagina Librerie client delle API Cloud pertinenti.
Utilizzo della piattaforma mobile Firebase
Firebase è la soluzione Google per la creazione di applicazioni sui dispositivi mobili. Offre un SDK con codice client che ti consente di accedere ad API Cloud pertinenti per il mobile da app per iOS, Android e web. Per informazioni sulle API Cloud supportate e su come iniziare a utilizzare Firebase, consulta la documentazione di Firebase.
Utilizzo del tuo codice client
Se hai esperienza di sviluppo e le librerie client di Google non soddisfano le tue esigenze specifiche, puoi scrivere codice personalizzato per accedere direttamente alle API di servizio di livello inferiore del servizio.
API REST/HTTP
Tutte le API Cloud espongono una semplice interfaccia JSON/REST tradizionale. Se hai bisogno di scrivere codice personalizzato per accedere direttamente all'API REST utilizzando una libreria client HTTP di terze parti, puoi trovare ulteriori informazioni su come le API Cloud funzionano con le diverse versioni e implementazioni HTTP nelle linee guida HTTP.
API gRPC
gRPC è un sistema open source, indipendente dal linguaggio e dalla piattaforma, per chiamata di procedura remota (RPC) sviluppato inizialmente in Google. Puoi scoprirlo all'indirizzo grpc.io. Le API Cloud abilitate per gRPC hanno in genere interfacce REST e RPC, quindi, anziché usare JSON su HTTP per comunicare con l'interfaccia REST, i client API abilitati per gRPC possono anche usare i buffer di protocollo e gRPC su HTTP2 per comunicare con l'interfaccia RPC. Per sapere se un'API è abilitata gRPC, controlla le API e la sezione di riferimento corrispondenti.
Se un'API Cloud è abilitata per gRPC, puoi generare le tue librerie client gRPC in qualsiasi linguaggio supportato da gRPC. A tale scopo, avrai bisogno della definizione del servizio dei buffer di protocollo dell'API (in genere disponibile nel repository su GitHub). Puoi quindi seguire le istruzioni per la tua lingua preferita su grpc.io per generare e utilizzare il tuo client.
Se non vuoi generare il tuo codice gRPC personalizzato, puoi comunque trarre vantaggio da gRPC: un numero crescente di librerie client di Cloud per le API abilitate per gRPC utilizza gRPC per comunicare con i server di Google. Ciò è notevolmente più efficiente in termini di velocità effettiva e di utilizzo della CPU; l'accesso a un'API mediante gRPC può aumentare la velocità effettiva per CPU di un fattore fino a 10 rispetto all'API REST JSON. Google prevede di eseguire l'upgrade a gRPC del maggior numero possibile di librerie client Cloud; nel frattempo, potrai usufruire di tutti gli altri vantaggi del codice della libreria client di Google.
Altri modi per accedere alle API Cloud
Se non vuoi accedere a un'API in modo programmatico, puoi accedere ad alcune delle stesse funzionalità utilizzando gli strumenti di Google Cloud CLI o la console Google Cloud.