Questa pagina mostra come iniziare a utilizzare le librerie client di Cloud per l'API Gemini Enterprise for Customer Experience. Le librerie client semplificano l'accesso alle APIGoogle Cloud da una lingua supportata. Sebbene tu possa utilizzare le APIGoogle Cloud effettuando direttamente delle richieste non elaborate al server, le librerie client forniscono semplificazioni che riducono notevolmente la quantità di codice da scrivere.
Scopri di più sulle librerie client di Cloud e sulle precedenti librerie client delle API di Google in Descrizione delle librerie client.
Installa la libreria client
C#
Se utilizzi Visual Studio 2017 o versioni successive, apri la finestra del gestore di pacchetti NuGet e digita quanto segue:Install-Package Google.Cloud.Ces.V1
Se utilizzi gli strumenti con interfaccia a riga di comando .NET Core per installare le dipendenze, esegui questo comando:
dotnet add package Google.Cloud.Ces.V1
Se utilizzi V1Beta, usa Google.Cloud.Ces.V1Beta come nome del pacchetto.
Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo C#.
Go
go get -d cloud.google.com/go/ces/apiv1
go get -d cloud.google.com/go/ces/apiv1beta
Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Go.
Java
Consulta le istruzioni del repository GitHub.Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Java.
Node.js
npm install @google-cloud/ces
Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Node.js.
Python
pip install --upgrade google-cloud-ces
Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Python.
Configura l'autenticazione
Per autenticare le chiamate alle API Google Cloud , le librerie client supportano il servizio Credenziali predefinite dell'applicazione (ADC). Le librerie cercano le credenziali in una serie di località definite e le utilizzano per autenticare le richieste all'API. Con le ADC, puoi rendere disponibili le credenziali per la tua applicazione in vari ambienti, ad esempio per lo sviluppo locale o la produzione, senza dover modificare il codice dell'applicazione.Per gli ambienti di produzione, la modalità di configurazione delle credenziali ADC dipende dal servizio e dal contesto. Per ulteriori informazioni, consulta Configura le credenziali predefinite dell'applicazione.
Per un ambiente di sviluppo locale, puoi configurare come ADC le credenziali associate al tuo Account Google:
-
Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:
gcloud initSe utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Non è necessario eseguire questa operazione se utilizzi Cloud Shell.
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
Viene visualizzata una schermata di accesso. Dopo aver eseguito l'accesso, le tue credenziali vengono archiviate nel file delle credenziali locali utilizzato da ADC.
Risorse aggiuntive
C#
Il seguente elenco contiene link ad altre risorse relative alla libreria client per C#:
Go
Il seguente elenco contiene link ad altre risorse relative alla libreria client per Go:
Java
Il seguente elenco contiene link ad altre risorse relative alla libreria client per Java:
Node.js
Il seguente elenco contiene link ad altre risorse relative alla libreria client per Node.js:
Python
Il seguente elenco contiene link ad altre risorse relative alla libreria client per Python: