Library klien CX Agent Studio

Halaman ini menunjukkan cara memulai Library Klien Cloud untuk Customer Engagement Suite API. Library klien mempermudah aksesGoogle Cloud API dari bahasa yang didukung. Meskipun Anda dapat menggunakanGoogle Cloud API secara langsung dengan membuat permintaan mentah ke server, library klien memberikan penyederhanaan yang secara signifikan mengurangi jumlah kode yang perlu ditulis.

Baca lebih lanjut Library Klien Cloud dan Library Klien Google API versi lama di Penjelasan library klien.

Menginstal library klien

C#

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

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

Hubungi kontak Akun Google Anda untuk mendapatkan petunjuk.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan C#.

Go

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

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

Clone cloud.google.com/go dan ambil jalur seperti ini:

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

Ekstrak file tar: tar -xzpf gapi-cloud-ces-v1-go.tar.gz. Kemudian, salin sumber ke direktori CLOUD_GO.

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

Dari direktori root modul Go yang menggunakan klien, ganti dependensi klien dengan clone lokal.

Catatan: Jika ini bukan modul baru, dan submodul telah dipublikasikan ke CLOUD_GO, targetkan dependensi modul tersebut dengan perintah berikut.

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

Sekarang library klien yang dibuat secara lokal siap digunakan.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan Go.

Java

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

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

Anda dapat memilih salah satu dari dua opsi yang tersedia:

Opsi 1 (direkomendasikan): Instal klien di cache maven lokal:

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

Setelah itu, klien dapat digunakan dari project Gradle atau Maven mana pun dengan cara konvensional. Lihat contoh berikut untuk menambahkan library klien Java yang dibuat secara lokal ke project Maven:

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

Opsi 2: Cukup buat jar klien dan tarik semua dependensinya dalam satu folder:

./gradlew clean allJars

Setelah itu, periksa folder all-jars. Folder tersebut harus berisi semua JAR yang diperlukan untuk menjalankan klien (yaitu klien itu sendiri dan semua dependensi langsung dan transitifnya).

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan Java.

Node.js

Download ces-v1-nodejs.tar.gz.

Download ces-v1beta-nodejs.tar.gz.

NPM mendukung penginstalan lokal menggunakan file tar yang dihasilkan oleh npm pack.

Pertama, ekstrak file yang dihasilkan oleh Bazel:

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

Di folder yang belum di-unzip, jalankan npm install untuk mengompilasi library dan npm pack untuk mengemas hasilnya ke dalam file .tgz agar dapat digunakan oleh npm:

npm install
npm pack

File yang dihasilkan dapat diteruskan ke npm install:

npm install RESULTING_FILE

Aset ini juga dapat didistribusikan dalam project.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan Node.js.

PHP

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

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

Buka paket ini ke dalam folder di project Anda, misalnya:

tar xvf path/to/LIBRARY.tar.gz

Tindakan ini akan mengekstrak library klien ke folder lokal. Pindahkan folder ini ke root project Anda, lalu tambahkan kode berikut ke composer.json project Anda (atau buat jika belum ada):

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

Tindakan ini menambahkan dependensi google/gax, dan mengidentifikasi direktori tempat file class dapat ditemukan dan dimuat otomatis oleh composer.

Jalankan composer install, sertakan vendor/autoload.php dalam kode Anda, dan Anda siap menggunakannya.

Untuk mengetahui informasi selengkapnya, lihat Menggunakan PHP di Google Cloud.

Python

Download ces-v1-py.tar.gz.

Download ces-v1beta-py.tar.gz.

Siapkan lingkungan virtual terlebih dahulu:

python3 -m venv env
source env/bin/activate

Kemudian, instal library dari file tar:

pip install ces-v1-py.tar.gz

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan Python.

Ruby

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

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

Hubungi kontak Akun Google Anda untuk mendapatkan petunjuk.

Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Lingkungan Pengembangan Ruby.

Menyiapkan autentikasi

Untuk mengautentikasi panggilan ke Google Cloud API, library klien mendukung Kredensial Default Aplikasi (ADC). Library ini mencari kredensial dalam kumpulan lokasi yang ditentukan dan menggunakan kredensial tersebut untuk mengautentikasi permintaan ke API. Dengan ADC, Anda dapat menyediakan kredensial untuk aplikasi di berbagai lingkungan, seperti produksi atau pengembangan lokal, tanpa perlu mengubah kode aplikasi.

Untuk lingkungan produksi, cara menyiapkan ADC bergantung pada layanan dan konteksnya. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi.

Untuk lingkungan pengembangan lokal, Anda dapat menyiapkan ADC dengan kredensial yang terkait dengan Akun Google Anda:

  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.

    Layar login akan muncul. Setelah Anda login, kredensial Anda akan disimpan dalam file kredensial lokal yang digunakan oleh ADC.

Referensi lainnya

C#

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk C#:

Go

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk Go:

Java

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk Java:

Node.js

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk Node.js:

PHP

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk PHP:

Python

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk Python:

Ruby

Daftar berikut berisi link ke referensi lainnya yang terkait dengan library klien untuk Ruby: