Le librerie client semplificano l'accesso alle Google Cloud API da un linguaggio supportato. Sebbene tu possa utilizzare Google Cloud direttamente le API inviando richieste non elaborate al server, 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 scoprire di più sulle librerie disponibili per il tuo prodotto o la tua lingua preferita nella documentazione del prodotto o della lingua.
Librerie client cloud
Le librerie client di Cloud sono l'opzione consigliata per accedere alle API Cloud a livello di programmazione, se disponibili. Le librerie client di Cloud utilizzano il modello di libreria client più recente e:
- Fornisci codice idiomatico in ogni lingua per semplificare e rendere intuitivo l'utilizzo delle API Cloud.
- Fornisci uno stile coerente tra le librerie client per semplificare il lavoro con più servizi Cloud.
- Gestisci tutti i dettagli di basso livello della comunicazione con il server, inclusa l'autenticazione con Google.
- Può essere installato utilizzando strumenti di gestione dei pacchetti familiari come
npmepip. - In alcuni casi, offre vantaggi in termini di prestazioni grazie all'utilizzo di gRPC. Per maggiori informazioni, consulta le API gRPC.
Puoi trovare istruzioni di installazione e materiale di riferimento per la libreria client Cloud nella pagina Librerie client per le API Cloud che utilizzi. 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
Per alcune API Google Cloud non sono disponibili librerie client di Cloud in tutti i linguaggi. Se vuoi utilizzare una di queste API e non esiste una libreria client Cloud per il tuo linguaggio preferito, puoi comunque utilizzare lo stile precedente di libreria client, chiamato librerie client dell'API di Google. Puoi utilizzare queste librerie anche se stai eseguendo l'upgrade di un progetto che già le utilizza. Queste librerie:
- Fornisci l'accesso solo all'interfaccia REST dell'API; gRPC non è supportato.
- Avere codice di interfaccia generato automaticamente che potrebbe non essere così idiomatico come le librerie client Cloud.
- Gestisci tutti i dettagli di basso livello della comunicazione con il server, inclusa l'autenticazione con Google.
- Può essere installato utilizzando strumenti di gestione dei pacchetti familiari come
npmepip.
Queste librerie sono collegate nella pagina Librerie client per le API Cloud pertinenti.
Utilizzo della piattaforma mobile Firebase
Firebase è la soluzione di Google per la creazione di applicazioni su dispositivi mobili. Offre un SDK con codice client che ti consente di accedere alle API Cloud pertinenti per il mobile da app web, Android e iOS. Per informazioni sulle API Cloud supportate e su come iniziare a utilizzare Firebase, consulta la documentazione di Firebase.
Utilizzo del tuo codice client
Se sei uno sviluppatore esperto e le librerie client di Google non soddisfano le tue esigenze specifiche, puoi scrivere il tuo codice personalizzato per accedere direttamente alle API di servizio di livello inferiore del servizio.
API REST/HTTP
Tutte le API Cloud mostrano una semplice interfaccia JSON/REST tradizionale. Se devi scrivere il tuo codice personalizzato per accedere direttamente all'API REST utilizzando una libreria client HTTP di terze parti, puoi scoprire di più su come le API Cloud funzionano con implementazioni e versioni HTTP diverse nelle linee guida HTTP.
API gRPC
gRPC è un sistema di chiamate di procedura remota (RPC) open source, indipendente da linguaggi e piattaforme, sviluppato inizialmente da Google. Puoi saperne di più all'indirizzo grpc.io. In genere, le API Cloud compatibili con gRPC hanno interfacce sia REST che RPC, quindi anziché utilizzare solo JSON su HTTP per comunicare con l'interfaccia REST, i client API compatibili con gRPC possono anche utilizzare buffer di protocollo e gRPC su HTTP2 per comunicare con l'interfaccia RPC. Puoi scoprire se un'API è supportata da gRPC controllandone la sezione API e riferimenti.
Se un'API Cloud è abilitata per gRPC, puoi generare le tue librerie client gRPC per qualsiasi linguaggio supportato da gRPC. Per farlo, devi disporre della definizione di servizio per i protocol buffer dell'API (in genere disponibile nel repository su GitHub). Puoi quindi seguire le istruzioni per la lingua che preferisci su grpc.io per generare e utilizzare il client.
Se non vuoi generare il tuo codice gRPC, puoi comunque usufruire di gRPC: un numero crescente di librerie client Cloud per le API compatibili con gRPC utilizza gRPC "sotto il cofano" per comunicare con i server di Google. Questo è molto più efficiente in termini di throughput e utilizzo della CPU: l'accesso a un'API tramite gRPC può aumentare il throughput per CPU fino a un fattore 10 rispetto all'API REST JSON. Google prevede di eseguire l'upgrade del maggior numero possibile di librerie client Cloud a gRPC. Nel frattempo, potrai comunque 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.