Le librerie client ti consentono di accedere alle API Google Cloud in modo programmatico con meno codice boilerplate gestendo l'autenticazione e la comunicazione di basso livello con il server. Questo documento illustra i seguenti metodi per interagire con le APIGoogle Cloud :
- Librerie client di Cloud (consigliate)
- Librerie client delle API di Google
- La piattaforma di sviluppo Firebase
- Il tuo codice cliente
Per trovare informazioni sulle librerie client per un prodotto Google Cloud specifico, consulta la sezione delle librerie client nella documentazione del prodotto.
Librerie client cloud
Sebbene tu possa utilizzare le API Google Cloud direttamente effettuando richieste non elaborate al server, le librerie client Cloud forniscono semplificazioni che riducono notevolmente la quantità di codice da scrivere. Le librerie client di Cloud sono l'opzione consigliata per accedere alle API Cloud in modo programmatico, perché utilizzano il modello di libreria client più recente e:
- Fornisci codice idiomatico in ogni lingua per rendere le Google Cloud API intuitive da usare.
- Fornire uno stile coerente tra le librerie client per semplificare l'utilizzo di più Google Cloud servizi.
- 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 noti come
npmepip. - In alcuni casi, offrono vantaggi in termini di prestazioni utilizzando gRPC. Per ulteriori informazioni, consulta API gRPC.
Le istruzioni di installazione e i materiali di riferimento per le librerie client 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 Google Cloud libreria API.
Librerie 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.
Potresti 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.
- Avere un codice di interfaccia generato automaticamente che potrebbe non essere idiomatico come le librerie client 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 noti come
npmepip.
Utilizzare la piattaforma di sviluppo Firebase
Firebase è la piattaforma di servizi di Google progettata per supportare l'intero ciclo di vita dello sviluppo di app. Fornisce SDK multipiattaforma per aiutare te e gli agenti AI a creare ed eseguire app per le piattaforme Apple, Android, il web, Flutter, Unity e C++.
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 di 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 dalla lingua e dalla piattaforma, sviluppato inizialmente da Google. Per saperne di più, visita il sito 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 a gRPC controllando la sezione API e riferimenti.
Se un'API Google Cloud è abilitata per gRPC, puoi generare le tue librerie client gRPC per qualsiasi linguaggio supportato da gRPC. Per farlo, devi avere la definizione del servizio protocol buffers dell'API (in genere disponibile dal 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 di 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 di Google Cloud CLI o la consoleGoogle Cloud .