CX Agent Studio-Clientbibliotheken

Auf dieser Seite werden die ersten Schritte mit den Cloud-Clientbibliotheken für die Customer Engagement Suite API beschrieben. Clientbibliotheken erleichtern den Zugriff auf APIs vonGoogle Cloud mit einer unterstützten Sprache. Sie können APIs vonGoogle Cloud direkt verwenden, indem Sie Rohanfragen an den Server senden. Clientbibliotheken bieten jedoch Vereinfachungen, die den zu schreibenden Code erheblich reduzieren.

Weitere Informationen zu den Cloud-Clientbibliotheken und den älteren Google API-Clientbibliotheken finden Sie unter Erläuterung zu Clientbibliotheken.

Clientbibliothek installieren

C#

Laden Sie google-cloud-ces-v1-csharp.tar.gz herunter.

Laden Sie google-cloud-ces-v1beta-csharp.tar.gz herunter.

Wenden Sie sich an Ihren Google-Kontakts, um eine Anleitung zu erhalten.

Weitere Informationen finden Sie unter .NET-Entwicklungsumgebung einrichten.

Go

Laden Sie gapi-cloud-ces-v1-go.tar.gz herunter.

Laden Sie gapi-cloud-ces-v1beta-go.tar.gz herunter.

Klonen Sie cloud.google.com/go und erfassen Sie den Pfad so:

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

Entpacken Sie die TAR-Datei: tar -xzpf gapi-cloud-ces-v1-go.tar.gz. Kopieren Sie dann die Quellen in das Verzeichnis CLOUD_GO.

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

Ersetzen Sie im Stammverzeichnis eines Go-Moduls, in dem der Client verwendet wird, die Clientabhängigkeit durch den lokalen Klon.

Hinweis: Wenn es sich nicht um ein brandneues Modul handelt und ein Untermodul in CLOUD_GO veröffentlicht wurde, verwenden Sie stattdessen den folgenden Befehl, um auf diese Modulabhängigkeit zu verweisen.

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

Die lokal generierte Clientbibliothek kann jetzt verwendet werden.

Weitere Informationen finden Sie unter Go-Entwicklungsumgebung einrichten.

Java

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

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

Sie haben die Wahl zwischen zwei Optionen:

Option 1 (empfohlen): Installieren Sie den Client in einem lokalen Maven-Cache:

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

Danach kann der Client auf herkömmliche Weise in jedem Gradle- oder Maven-Projekt verwendet werden. Im Folgenden finden Sie ein Beispiel für das Hinzufügen der lokal erstellten Java-Clientbibliothek zu einem Maven-Projekt:

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

Option 2:Erstellen Sie nur die Client-JAR-Datei und ziehen Sie alle zugehörigen Abhängigkeiten in einen einzelnen Ordner:

./gradlew clean allJars

Prüfen Sie dann den Ordner all-jars. Er sollte alle JAR-Dateien enthalten, die zum Ausführen des Clients erforderlich sind, d. h. den Client selbst und alle seine direkten und transitiven Abhängigkeiten.

Weitere Informationen finden Sie unter Java-Entwicklungsumgebung einrichten.

Node.js

Laden Sie ces-v1-nodejs.tar.gz herunter.

Laden Sie ces-v1beta-nodejs.tar.gz herunter.

NPM unterstützt lokale Installationen mit der TAR-Datei, die von npm pack erstellt wurde.

Entpacken Sie zuerst die von Bazel erstellte Datei:

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

Führen Sie im entpackten Ordner npm install aus, um die Bibliothek zu kompilieren, und npm pack, um das Ergebnis in die Datei .tgz zu packen, die von npm verwendet wird:

npm install
npm pack

Die resultierende Datei kann an npm install übergeben werden:

npm install RESULTING_FILE

Sie kann auch innerhalb des Projekts verteilt werden.

Weitere Informationen finden Sie unter Node.js-Entwicklungsumgebung einrichten.

PHP

Laden Sie google-cloud-ces-v1-php.tar.gz herunter.

Laden Sie google-cloud-ces-v1beta-php.tar.gz herunter.

Entpacken Sie die Datei in einen Ordner in Ihrem Projekt, z. B.:

tar xvf path/to/LIBRARY.tar.gz

Dadurch wird die Clientbibliothek in einen lokalen Ordner entpackt. Verschieben Sie diesen Ordner in das Stammverzeichnis Ihres Projekts und fügen Sie der composer.json Ihres Projekts Folgendes hinzu (oder erstellen Sie eine, falls sie nicht vorhanden ist):

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

Dadurch wird die google/gax-Abhängigkeit hinzugefügt und die Verzeichnisse werden identifiziert, in denen die Klassendateien gefunden und von Composer automatisch geladen werden können.

Führen Sie composer install aus, fügen Sie vendor/autoload.php in Ihren Code ein und schon kann es losgehen.

Weitere Informationen finden Sie unter PHP auf Google Cloud verwenden.

Python

Laden Sie ces-v1-py.tar.gz herunter.

Laden Sie ces-v1beta-py.tar.gz herunter.

Richten Sie zuerst eine virtuelle Umgebung ein:

python3 -m venv env
source env/bin/activate

Installieren Sie die Bibliothek dann aus der TAR-Datei:

pip install ces-v1-py.tar.gz

Weitere Informationen finden Sie unter Python-Entwicklungsumgebung einrichten.

Ruby

Laden Sie google-cloud-ces-v1-ruby.tar.gz herunter.

Laden Sie google-cloud-ces-v1beta-ruby.tar.gz herunter.

Wenden Sie sich an Ihren Google-Kontakts, um eine Anleitung zu erhalten.

Weitere Informationen finden Sie unter Ruby-Entwicklungsumgebung einrichten.

Authentifizierung einrichten

Zur Authentifizierung von Aufrufen an APIs von Google Cloud unterstützen Clientbibliotheken Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC). Die Bibliotheken suchen nach Anmeldedaten an einer Reihe von definierten Speicherorten und verwenden diese, um Anfragen an die API zu authentifizieren. Mit ADC können Sie Anmeldedaten für Ihre Anwendung in verschiedenen Umgebungen bereitstellen, z. B. in der lokalen Entwicklung oder Produktion, ohne den Anwendungscode ändern zu müssen.

In Produktionsumgebungen hängt die Art der Einrichtung von ADC vom Dienst und Kontext ab. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.

Für eine lokale Entwicklungsumgebung können Sie ADC mit den Anmeldedaten einrichten, die Ihrem Google-Konto zugeordnet sind:

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.
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.

Ein Anmeldebildschirm wird angezeigt. Nach der Anmeldung werden Ihre Anmeldedaten in der lokalen Anmeldedatendatei für ADC gespeichert.

Zusätzliche Ressourcen

C#

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für C#:

Go

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für Go:

Java

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für Java:

Node.js

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für Node.js:

PHP

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für PHP:

Python

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für Python:

Ruby

Die folgende Liste enthält Links zu weiteren Ressourcen im Zusammenhang mit der Clientbibliothek für Ruby:

CX Agent Studio-Clientbibliotheken Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Clientbibliothek installieren

C#

Go

Java

Node.js

PHP

Python

Ruby

Authentifizierung einrichten

Zusätzliche Ressourcen

C#

Go

Java

Node.js

PHP

Python

Ruby

CX Agent Studio-Clientbibliotheken