Library klien mengoptimalkan pengalaman developer untuk memanggil Google Chat API dengan mengurangi kode boilerplate yang harus Anda tulis. Panduan ini memperkenalkan library klien dan menjelaskan cara menginstalnya.
Chat API memiliki antarmuka gRPC dan REST, serta library klien yang mendukung keduanya. Library Klien Cloud mendukung antarmuka gRPC dan REST, Library Klien Google API hanya mendukung antarmuka REST, tetapi Anda dapat menggunakan kedua library klien dalam project yang sama. Secara opsional, jika library klien yang disediakan tidak memenuhi kebutuhan Anda, Anda dapat menulis library klien Anda sendiri yang menggunakan antarmuka gRPC atau REST.
Untuk mempelajari lebih lanjut jenis library klien yang didukung Google, lihat Penjelasan library klien.
Menginstal Library Klien Cloud (direkomendasikan)
Library Klien Cloud adalah library klien terbaru dan direkomendasikan untuk memanggil Chat API. Library Klien Cloud mendukung antarmuka gRPC dan REST.
Chat API menyediakan Library Klien Cloud untuk bahasa berikut. Pilih bahasa yang ingin digunakan:
Node.js
Untuk menginstal library klien:
npm install @google-apps/chat
Pelajari lebih lanjut:
Python
Untuk menginstal library klien:
python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
Pelajari lebih lanjut:
Java
Pilih lingkungan build dari tab berikut. Apa pun yang Anda gunakan, jangan lupa untuk mengupdate versi ke rilis terbaru yang tersedia di GitHub.
Maven dengan BOM
Jika Anda menggunakan Maven dengan
BOM,
tambahkan kode berikut ke file pom.xml
:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.42.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
</dependency>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.10.0</version>
</dependency>
Maven tanpa BOM
Jika Anda menggunakan Maven tanpa BOM, tambahkan kode berikut ke dependensi Anda:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
Jika Anda menggunakan Gradle tanpa BOM, tambahkan kode berikut ke dependensi Anda:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
Jika Anda menggunakan SBT, tambahkan kode ini ke dependensi Anda:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
Pelajari lebih lanjut:
Go
Mengimpor paket Go untuk layanan Google Cloud.
import "cloud.google.com/go"
Untuk menginstal paket di sistem Anda:
- Ubah ke direktori project Anda:
cd /my/cloud/project
. - Dapatkan paket yang ingin Anda gunakan:
go get cloud.google.com/go/chat
Pelajari lebih lanjut:
Ruby
Untuk menginstal library klien:
gem install google-apps-chat
Pelajari lebih lanjut:
PHP
Untuk menginstal library klien:
- Jika perlu, instal pengelola dependensi Composer.
- Dari antarmuka command line, jalankan:
composer require google/apps-chat
Pelajari lebih lanjut:
.NET
Untuk menginstal library klien:
Instal paket Google.Apps.Chat.V1
dari NuGet. Tambahkan ke project Anda
dengan cara biasa (misalnya dengan mengklik kanan project di
Visual Studio dan memilih "Manage NuGet Packages..."). Pastikan Anda mengaktifkan paket pra-rilis (misalnya, di antarmuka pengguna Visual Studio NuGet, centang kotak "Sertakan pra-rilis").
Untuk menginstal paket NuGet, buka Google.Apis di NuGet.org.
Pelajari lebih lanjut:
Menginstal Library Klien Google API
Sebagai alternatif untuk Library Klien Cloud, Library Klien Google API menyediakan akses terprogram ke Chat API menggunakan resource dan metode REST. Anda mungkin lebih memilih untuk menggunakan Library Klien Google API jika menggunakan bahasa yang tidak memiliki Library Klien Cloud, atau jika Anda memperluas project yang sudah menggunakannya.
Chat API menyediakan Library Klien Google API untuk bahasa berikut. Pilih bahasa yang ingin digunakan:
Go
Dapatkan library klien Google Chat API terbaru untuk Go (alfa). Baca panduan developer terkait library klien.
Java
Halaman ini berisi informasi tentang cara memulai Google Chat API menggunakan Library Klien Google API untuk Java. Untuk informasi selengkapnya, lihat dokumentasi berikut:
Menambahkan library klien ke project
Pilih lingkungan build (Maven atau Gradle) dari tab berikut:
Tambahkan baris berikut ke file pom.xml
Anda:
Lihat semua versi yang tersedia di Maven Central Repository.
Tambahkan baris berikut ke file build.gradle
Anda:
Lihat semua versi yang tersedia di Maven Central Repository.
JavaScript
Baca panduan developer untuk library klien ini.
.NET
Halaman ini berisi informasi tentang cara memulai Google Chat API menggunakan Library Klien Google API untuk .NET. Untuk informasi selengkapnya, lihat dokumentasi berikut:
Mendownload library
Instal paket NuGet: Google.Apis.
Node.js
Dapatkan library klien Google Chat API terbaru untuk Node.js. Baca panduan developer terkait library klien.
Obj-C
Dapatkan library klien Google Chat API terbaru untuk Objective-C. Baca panduan developer terkait library klien.
PHP
Dapatkan library klien Google Chat API terbaru untuk PHP. Baca panduan developer terkait library klien.
Python
Halaman ini berisi informasi tentang cara memulai Google Chat API menggunakan Library Klien Google API untuk Python. Untuk informasi selengkapnya, lihat dokumentasi berikut:
Persyaratan sistem
- Sistem operasi:
- Linux
- macOS X
- Windows
- Python 2.7, 3.4, atau yang lebih tinggi
Menginstal library klien
Anda dapat menggunakan pengelola paket atau mendownload dan menginstal library klien Python secara manual:
Penginstalan terkelola
Gunakan pip atau setuptools untuk mengelola penginstalan. Anda mungkin
perlu menjalankan sudo
terlebih dahulu.
- pip (lebih disarankan):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
Penginstalan manual
- Download library klien terbaru untuk Python.
- Ekstrak kodenya.
- Instal:
python setup.py install
App Engine
Karena library klien Python tidak diinstal di lingkungan runtime App Engine Python, Anda harus menyalinnya ke aplikasi sama seperti library pihak ketiga.
Ruby
Halaman ini berisi informasi cara memulai Google Chat API menggunakan Library Klien Google API untuk Ruby. Untuk informasi selengkapnya, lihat dokumentasi berikut:
Menginstal gem google-api-client
Bergantung pada sistemnya, Anda mungkin perlu mengawali perintah tersebut dengan sudo
.
Jika Anda belum pernah menginstal Library Klien Google API untuk Ruby, instal menggunakan RubyGems
:
gem install google-api-client
Jika Anda sudah pernah menginstal gem ini, update ke versi terbaru:
gem update -y google-api-client
Memulai Library Klien Google API untuk Ruby
Untuk mempelajari cara membuat permintaan pertama Anda, lihat Panduan memulai.
Apps Script dan library klien
Cara yang direkomendasikan bagi sebagian besar developer untuk memanggil Google Chat API adalah dengan menggunakan Library Klien Cloud kami yang didukung secara resmi untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.
Jika Anda melakukan coding dengan Google Apps Script, gunakan layanan Chat Lanjutan, bukan menginstal library klien.
Autentikasi
Memanggil Chat API memerlukan autentikasi. Setiap metode Chat API memerlukan autentikasi pengguna (untuk melakukan tindakan atau mengakses data atas nama pengguna) atau autentikasi aplikasi (untuk melakukan tindakan atau mengakses data sebagai aplikasi Chat). Beberapa metode mendukung autentikasi pengguna dan autentikasi aplikasi.
Untuk mempelajari autentikasi di Chat lebih lanjut, lihat Ringkasan autentikasi.