Descrizione delle librerie client

Le librerie client semplificano l'accesso API Google Cloud di una lingua supportata. Puoi utilizzare le API Google Cloud direttamente tramite richieste non elaborate al server, le librerie client offrono semplificazioni che riducono significativamente la quantità di codice da scrivere.

Questo documento illustra i diversi tipi di librerie client che 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

Librerie client di Cloud sono l'opzione consigliata per accedere alle API Cloud in modo programmatico, disponibili. 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 intuitivo da usare.
  • 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, tra cui l'autenticazione con Google.
  • Può essere installato utilizzando strumenti di gestione dei pacchetti familiari come npm e pip.
  • In alcuni casi, utilizza gRPC per ottenere vantaggi in termini di prestazioni. Per maggiori informazioni, consulta le API gRPC.

Sono disponibili le istruzioni per l'installazione e il materiale di riferimento per Libreria client di Cloud nella pagina Librerie client per API Cloud che stai utilizzando. Puoi trovare i link per iniziare a utilizzare le librerie client di Cloud e relativa documentazione di riferimento sul 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 gratuitamente

Librerie 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. Potresti utilizzare queste librerie anche se stai eseguendo l'upgrade di un progetto che ha già che li utilizza. Queste librerie:

  • fornire l'accesso solo all'interfaccia REST dell'API; gRPC non è supportato.
  • Avere un codice dell'interfaccia generato automaticamente che potrebbe non essere così idiomatico come Librerie client di Cloud.
  • Gestire tutti i dettagli di basso livello della comunicazione con il server, tra cui l'autenticazione con Google.
  • Può essere installato utilizzando strumenti di gestione di pacchetti che già conosci come npm e pip.

Queste librerie sono collegate alla pagina Librerie client per il Cloud pertinente su quelle di livello inferiore.

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 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. Per scrivere il tuo codice personalizzato per accedere direttamente all'API REST tramite un nella libreria client HTTP, puoi scoprire di più su come funzionano le API Cloud nelle diverse versioni e implementazioni HTTP Linee guida per HTTP.

API gRPC

gRPC è un sistema open source di chiamate di procedura remota (RPC) 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 tua lingua preferita sul grpc.io per generare e utilizzare il tuo 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 è notevolmente più efficiente in termini di velocità effettiva e utilizzo della CPU, accedendo a un'API gRPC può aumentare la velocità effettiva per CPU di un fattore pari a 10 rispetto all'API REST JSON. Google prevede di eseguire l'upgrade del maggior numero di librerie client Cloud possibile a gRPC; nel frattempo, continuerai ad avere tutti gli altri vantaggi della Codice 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 della stessa funzionalità usando gli strumenti Google Cloud CLI o l'utilizzo Console Google Cloud.