Library klien mengoptimalkan pengalaman developer untuk memanggil Google Chat API dengan mengurangi kode boilerplate yang harus Anda tulis. Panduan ini memperkenalkan {i>library<i} klien dan menjelaskan cara menginstalnya.
Chat API memiliki gRPC dan REST antarmuka, dan yang mendukung keduanya. Library Klien Cloud mendukung gRPC dan REST ini, Library Klien Google API hanya mendukung antarmuka REST, dapat menggunakan kedua library klien di project yang sama. Secara opsional, jika {i>library<i} klien yang disediakan tidak memenuhi kebutuhan Anda, Anda dapat menulis yang menggunakan antarmuka gRPC atau REST.
Untuk mempelajari lebih lanjut tentang 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 API Chat. Library Klien Cloud mendukung gRPC dan REST antarmuka.
Chat API menyediakan Library Klien Cloud untuk bahasa berikut. Pilih bahasa yang ingin Anda gunakan:
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 Anda dari tab berikut. Mana pun Anda gunakan, ingatlah untuk memperbarui versi ke rilis terbaru yang tersedia di GitHub.
Maven dengan BOM
Jika Anda menggunakan Maven dengan
BOM,
tambahkan kode ini ke file pom.xml
Anda:
<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 ini 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 ini 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
Impor 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:
- Bila perlu, instal pengelola dependensi Komposer.
- 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
proyek dengan cara normal (misalnya dengan mengeklik kanan pada proyek di
Visual Studio dan pilih "Manage NuGet Packages..."). Pastikan Anda
aktifkan paket pra-rilis (misalnya, di antarmuka pengguna Visual Studio NuGet
centang antarmuka "Sertakan pra-rilis" boks).
Untuk menginstal paket NuGet, kunjungi Google.Apis di NuGet.org.
Pelajari lebih lanjut:
Menginstal Library Klien Google API
Alternatif untuk {i>Cloud Client Libraries<i}, Library Klien Google API menyediakan akses terprogram ke Chat API menggunakan resource REST dan metode. Anda mungkin lebih suka menggunakan Library Klien Google API jika Anda menggunakan bahasa yang tidak memiliki Library Klien Cloud, atau jika Anda memperluas project yang sudah menggunakannya.
Chat API menyediakan Library Klien Google API untuk hal-hal berikut bahasa. Pilih bahasa yang ingin Anda gunakan:
Go
Dapatkan library klien Google Chat API terbaru untuk Go (alfa). Baca panduan developer terkait library klien.
Java
Halaman ini berisi informasi 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 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 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 dengan dukungan resmi Library Klien Cloud untuk bahasa pilihan Anda, seperti Python, Java, atau Node.js.
Jika Anda membuat kode dengan Google Apps Script, gunakan Layanan Chat lanjutan alih-alih menginstal library klien.
Autentikasi
Memanggil Chat API memerlukan autentikasi. Masing-masing 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). Agak besar metode mendukung otentikasi pengguna dan otentikasi aplikasi.
Untuk mempelajari lebih lanjut autentikasi di Chat, lihat Ringkasan autentikasi.