Anche se puoi utilizzare le API Google Cloud direttamente effettuando richieste non elaborate al server, le librerie client forniscono semplificazioni che riducono notevolmente la quantità di codice che devi scrivere.
Questo documento spiega i metodi di interazione con le API Google Cloud :
- Librerie client di Cloud (consigliate)
- Librerie client delle API di Google
- Firebase mobile
- Il tuo codice cliente
Per trovare informazioni sulle librerie client per un prodotto specifico, consulta la sezione delle librerie client nella documentazione del prodotto. Google Cloud Per visualizzare tutte le librerie client di Cloud, spesso organizzate per linguaggio supportato, consulta Librerie client di Cloud.
Librerie client cloud
Le librerie client di Cloud sono l'opzione consigliata per accedere alle API Cloud a livello di programmazione, ove disponibili. Le librerie client di Cloud utilizzano il modello di libreria client più recente e:
- Fornisci codice idiomatico in ogni lingua per rendere le API intuitive da usare. Google Cloud
- Fornire uno stile coerente tra le librerie client per semplificare l'utilizzo di più servizi. Google Cloud
- Gestiscono 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 noti come
npmepip. - In alcuni casi, offrirti vantaggi in termini di prestazioni utilizzando gRPC. Per maggiori informazioni, consulta la pagina API gRPC.
Le istruzioni di installazione e i materiali di riferimento per le librerie client di Cloud dipendono dall'API Google Cloud specifica e dal linguaggio di programmazione che utilizzi. Per trovare queste informazioni, consulta la documentazione del prodotto Google Cloud specifico. La maggior parte dei prodotti include una sezione "Librerie client" nella documentazione, che fornisce indicazioni specifiche per la lingua, passaggi di installazione e link al riferimento API dettagliato.
Puoi trovare la documentazione di un prodotto specifico sfogliando la libreria API.Google 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
Se le librerie client di Cloud non sono disponibili per la lingua che preferisci per un'API specifica, puoi utilizzare le librerie client delle API di Google. Si tratta di un tipo precedente di libreria client fornita da Google.
Puoi utilizzare queste librerie anche se esegui l'upgrade di un progetto che le utilizza già. Queste librerie:
- Fornisci l'accesso solo all'interfaccia REST dell'API; gRPC non è supportato.
- Hanno un codice di interfaccia generato automaticamente che potrebbe non essere idiomatico come le librerie client Cloud.
- Gestiscono 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 noti come
npmepip.
Utilizzare la 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 Google Cloud pertinenti per il mobile da app iOS, Android e web. Per informazioni sulle API Google Cloud supportate e su come iniziare a utilizzare Firebase, consulta la documentazione di Firebase.
Utilizzare il proprio codice cliente
Se sei uno sviluppatore esperto e le librerie client Cloud 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 Google Cloud API espongono un'interfaccia JSON/REST. 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 Google Cloud le API funzionano con diverse versioni e implementazioni HTTP nelle linee guida HTTP.
API gRPC
gRPC è un sistema di chiamata di procedura remota (RPC) open source, indipendente dal linguaggio e dalla piattaforma, sviluppato inizialmente da Google. Per saperne di più, visita la pagina grpc.io. Le API Google Cloud abilitate per gRPC in genere hanno interfacce REST e RPC, quindi, anziché utilizzare solo JSON su HTTP per comunicare con l'interfaccia REST, i client API abilitati per gRPC possono utilizzare anche i buffer di protocollo e gRPC su HTTP2 per comunicare con l'interfaccia RPC. Puoi scoprire se un'API è abilitata per gRPC controllando la sezione API e riferimenti.
Se un' Google Cloud API è abilitata a gRPC, puoi generare le tue librerie client gRPC per l'API in qualsiasi linguaggio supportato da gRPC. Per farlo, devi avere la definizione del servizio protocol buffers 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 di Cloud per API abilitate a 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 utilizzando 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 di Cloud a gRPC. Nel frattempo, continuerai a 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 in Google Cloud CLI o utilizzando la consoleGoogle Cloud .