Librerie client CX Agent Studio

Questa pagina mostra come iniziare a utilizzare le librerie client di Cloud per l'API Customer Engagement Suite. 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#

Scarica google-cloud-ces-v1-csharp.tar.gz.

Scarica google-cloud-ces-v1beta-csharp.tar.gz.

Per ricevere istruzioni, contatta il tuo contatto dell'account Google.

Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo C#.

Go

Scarica gapi-cloud-ces-v1-go.tar.gz.

Scarica gapi-cloud-ces-v1beta-go.tar.gz.

Clona cloud.google.com/go e acquisisci il percorso nel seguente modo:

git clone https://github.com/googleapis/google-cloud-go
export CLOUD_GO=`pwd`/google-cloud-go

Decomprimi il file tar: tar -xzpf gapi-cloud-ces-v1-go.tar.gz. Poi, copia le origini nella directory CLOUD_GO.

Nota: il modulo principale è cloud.google.com/go, quindi scegli una directory più in profondità quando copi dal file tar. Alcuni pacchetti saranno nidificati in più directory come cloud.google.com/go/maps/maplearning.

cp -r ./cloud.google.com/go/gapi-cloud-ces-v1-go $CLOUD_GO

Dalla directory principale di un modulo Go che utilizza il client, sostituisci la dipendenza del client con il clone locale.

Nota: se non si tratta di un modulo nuovo di zecca e un sottomodulo è stato pubblicato su CLOUD_GO, scegli come target la dipendenza del modulo con il seguente comando invece.

go mod edit -replace=cloud.google.com/go=$CLOUD_GO

Ora la libreria client generata localmente è pronta per l'uso.

Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Go.

Java

Scarica google-cloud-ces-v1-java.tar.gz.

Scarica google-cloud-ces-v1beta-java.tar.gz.

Puoi scegliere una delle due opzioni possibili:

Opzione 1 (consigliata): installa il client in una cache Maven locale:

cd /path/to/library ./gradlew clean publishToMavenLocal

Dopodiché, il client può essere utilizzato da qualsiasi progetto Gradle o Maven in modo convenzionale. Per un esempio di aggiunta della libreria client Java creata localmente a un progetto Maven, consulta quanto segue:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.google.cloud</groupId>
            <artifactId>gapic-google-cloud-ces-v1-java</artifactId>
            <version>0.0.0-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>com.google.api</groupId>
            <artifactId>gax-bom</artifactId>
            <version>${gax-bom.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>gapic-google-cloud-ces-v1-java</artifactId>
    </dependency>
    <dependency>
        <groupId>com.google.api</groupId>
        <artifactId>gax</artifactId>
    </dependency>
    <dependency>
        <groupId>com.google.api</groupId>
        <artifactId>gax-grpc</artifactId>
    </dependency>
    <dependency>
        <groupId>com.google.api</groupId>
        <artifactId>gax-httpjson</artifactId>
    </dependency>
</dependencies>

Opzione 2: crea il file JAR del client ed estrai tutte le relative dipendenze in una singola cartella:

./gradlew clean allJars

Dopodiché, controlla la cartella all-jars, che dovrebbe contenere tutti i file JAR necessari per eseguire il client (ovvero il client stesso e tutte le sue dipendenze dirette e transitive).

Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Java.

Node.js

Scarica ces-v1-nodejs.tar.gz.

Scarica ces-v1beta-nodejs.tar.gz.

NPM supporta le installazioni locali utilizzando il file tar prodotto da npm pack.

Per prima cosa, decomprimi il file prodotto da Bazel:

tar xzf path/to/ces-v1-nodejs.tar.gz
cd ces-v1-nodejs

Nella cartella decompressa, esegui npm install per compilare la libreria e npm pack per comprimere il risultato nel file .tgz da utilizzare con npm:

npm install
npm pack

Il file risultante può essere trasferito a npm install:

npm install RESULTING_FILE

Può anche essere distribuito all'interno del progetto.

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Node.js.

PHP

Scarica google-cloud-ces-v1-php.tar.gz.

Scarica google-cloud-ces-v1beta-php.tar.gz.

Decomprimi questo file in una cartella del tuo progetto, ad esempio:

tar xvf path/to/LIBRARY.tar.gz

In questo modo la libreria client viene decompressa in una cartella locale. Sposta questa cartella nella root del progetto e aggiungi quanto segue al file composer.json del progetto (o creane uno se non esiste):

{
    "require": {
        "google/gax": "^1.34"
    },
    "autoload": {
        "classmap": [
            "LIBRARY/src",
            "LIBRARY/proto/src"
        ]
    }
}

In questo modo viene aggiunta la dipendenza google/gax e vengono identificate le directory in cui i file di classe possono essere trovati e caricati automaticamente da Composer.

Esegui composer install, includi vendor/autoload.php nel tuo codice e il gioco è fatto.

Per ulteriori informazioni, consulta Utilizzo di PHP su Google Cloud.

Python

Scarica ces-v1-py.tar.gz.

Scarica ces-v1beta-py.tar.gz.

Configura prima un ambiente virtuale:

python3 -m venv env
source env/bin/activate

Poi installa la libreria dal file tar:

pip install ces-v1-py.tar.gz

Per ulteriori informazioni, consulta Configurazione di un ambiente di sviluppo Python.

Ruby

Scarica google-cloud-ces-v1-ruby.tar.gz.

Scarica google-cloud-ces-v1beta-ruby.tar.gz.

Per ricevere istruzioni, contatta il tuo contatto dell'account Google.

Per ulteriori informazioni, vedi Configurazione di un ambiente di sviluppo Ruby.

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:

1. Install the Google Cloud CLI. After installation, initialize the Google Cloud CLI by running the following command:

   gcloud init

   If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

2. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

   If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

   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#:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

Go

Il seguente elenco contiene link ad altre risorse relative alla libreria client per Go:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

Java

Il seguente elenco contiene link ad altre risorse relative alla libreria client per Java:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

Node.js

Il seguente elenco contiene link ad altre risorse relative alla libreria client per Node.js:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

PHP

Il seguente elenco contiene link ad altre risorse relative alla libreria client per PHP:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

Python

Il seguente elenco contiene link ad altre risorse relative alla libreria client per Python:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente

Ruby

Il seguente elenco contiene link ad altre risorse relative alla libreria client per Ruby:

• Riferimento API
• Best practice per le librerie client
• Issue Tracker
• gemini-enterprise-cx su Stack Overflow
• Codice sorgente