Halaman ini menjelaskan cara membuat dan berinteraksi dengan aplikasi Chat menggunakan Google Cloud Functions.
Untuk membuat aplikasi, tulis dan deploy Cloud Function yang digunakan aplikasi untuk memproses respons terhadap peristiwa pesan dari Google Chat. Responsnya adalah kartu yang menampilkan nama pengirim dan gambar avatar, seperti yang ditunjukkan pada gambar berikut:
Tujuan
- Menyiapkan lingkungan.
- Membuat dan men-deploy Cloud Function.
- Publikasikan aplikasi ke Google Chat.
- Uji aplikasi.
Prasyarat
- Akun Google Workspace dengan akses ke Google Chat.
- Project Google Cloud.
- Pastikan Anda mengaktifkan penagihan untuk project Cloud. Pelajari cara memverifikasi status penagihan project.
Menyiapkan lingkungan
Sebelum menggunakan Google API, Anda perlu mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di Google Cloud Console, aktifkan Google Chat API, Cloud Build API, Cloud Functions API, dan Cloud Pub/Sub API.
Membuat dan men-deploy Cloud Function
Buat dan deploy Cloud Function yang menghasilkan kartu Chat dengan nama tampilan dan gambar avatar pengirim. Saat menerima pesan, aplikasi Chat akan menjalankan fungsi dan merespons dengan kartu.
Untuk membuat dan men-deploy fungsi aplikasi Chat, selesaikan langkah-langkah berikut:
Node.js
Di Google Cloud Console, buka halaman Cloud Functions:
Pastikan project untuk aplikasi Chat Anda dipilih.
Klik
Create Function.Di halaman Buat fungsi, siapkan fungsi Anda:
- Di bagian Nama fungsi, masukkan "QuickStartChatApp".
- Pada Jenis pemicu, pilih HTTP.
Di bagian Authentication, pilih Allow unauthenticated invocations.
Untuk informasi selengkapnya tentang autentikasi di Google Workspace, lihat Mengautentikasi dan memberi otorisasi aplikasi Chat dan permintaan API.
Klik Simpan.
Klik Next.
Di Runtime, pilih Node.js 10.
Pada Source code, pilih Inline Editor.
Di Titik entri, hapus teks default dan masukkan
helloChat
.Ganti konten
index.js
dengan kode berikut:Klik Deploy.
Python
Di Google Cloud Console, buka halaman Cloud Functions:
Pastikan project untuk aplikasi Chat Anda dipilih.
Klik
Create Function.Di halaman Buat fungsi, siapkan fungsi Anda:
- Di bagian Nama fungsi, masukkan "QuickStartChatApp".
- Pada Jenis pemicu, pilih HTTP.
Di bagian Authentication, pilih Allow unauthenticated invocations.
Untuk informasi selengkapnya tentang autentikasi di Google Workspace, lihat Mengautentikasi dan memberi otorisasi aplikasi Chat dan permintaan API.
Klik Simpan.
Klik Next.
Di Runtime, pilih Python 3.10.
Pada Source code, pilih Inline Editor.
Di Titik entri, hapus teks default dan masukkan
hello_chat
.Ganti konten
main.py
dengan kode berikut:Klik Deploy.
Java
Di Google Cloud Console, buka halaman Cloud Functions:
Pastikan project untuk aplikasi Chat Anda dipilih.
Klik
Create Function.Di halaman Buat fungsi, siapkan fungsi Anda:
- Di bagian Nama fungsi, masukkan "QuickStartChatApp".
- Pada Jenis pemicu, pilih HTTP.
Di bagian Authentication, pilih Allow unauthenticated invocations.
Untuk mengetahui informasi selengkapnya tentang autentikasi di Google Workspace, lihat Mengautentikasi dan memberi otorisasi aplikasi Chat dan permintaan API.
Klik Simpan.
Klik Next.
Di Runtime, pilih Java 11.
Pada Source code, pilih Inline Editor.
Di Titik entri, hapus teks default dan masukkan
HelloChat
.Mengganti nama
src/main/java/com/example/Example.java
menjadisrc/main/java/HelloChat.java
.Ganti konten
HelloChat.java
dengan kode berikut:Ganti konten
pom.xml
dengan kode berikut:Klik Deploy.
Halaman Cloud Functions akan terbuka dan fungsi Anda muncul dengan indikator progres deployment di samping nama fungsi. Saat indikator progres hilang dan tanda centang muncul, fungsi Anda akan di-deploy.
Memublikasikan aplikasi ke Google Chat
Setelah Cloud Function di-deploy, ikuti langkah-langkah berikut untuk mengubahnya menjadi aplikasi Google Chat:
Di Google Cloud Console, klik Menu > Cloud Functions.
Pastikan project tempat Anda mengaktifkan Cloud Functions dipilih.
Dalam daftar fungsi, klik QuickStartChatApp.
Di halaman detail Fungsi, klik Pemicu.
Di bagian URL Pemicu, salin URL-nya.
Telusuri "Google Chat API", lalu klik Google Chat API.
Klik Manage.
Klik Konfigurasi, lalu siapkan aplikasi Google Chat:
- Di bagian Nama aplikasi, masukkan
Quickstart App
. - Di URL Avatar, masukkan
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Di Description, masukkan
Quickstart app
. - Pada bagian Fungsi, pilih Terima pesan 1:1, Gabung ke ruang dan percakapan grup, lalu Catat error ke Cloud Logging.
- Di bagian Connection settings, pilih App URL, lalu tempelkan URL untuk pemicu Cloud Function ke dalam kotak.
- Pada Izin, pilih Orang dan grup tertentu di domain Anda, lalu masukkan alamat email.
- Di bagian Nama aplikasi, masukkan
Klik Simpan.
Aplikasi siap menerima dan merespons pesan di Google Chat.
Menguji aplikasi Chat
Untuk menguji aplikasi Chat Anda, kirim pesan langsung ke aplikasi:
- Buka Google Chat.
- Untuk mengirim pesan langsung ke aplikasi, klik Mulai chat , dan di jendela yang muncul, klik Temukan aplikasi.
- Pada dialog Find apps, telusuri "Quickstart App".
- Untuk membuka pesan langsung dengan aplikasi, temukan Aplikasi Panduan Memulai dan klik Tambahkan > Chat.
- Dalam pesan langsung, ketik
Hello
dan tekanenter
.
Aplikasi menampilkan kartu dengan nama tampilan dan gambar avatar Anda.
Langkah berikutnya
Untuk memecahkan masalah dan men-debug aplikasi Chat, lihat halaman berikut:
- Saat membuat aplikasi Chat, Anda mungkin perlu melakukan debug dengan membaca log error aplikasi. Untuk membaca log, di Google Cloud Console, buka Logs Explorer.
- Pemecahan masalah.
Untuk menambahkan lebih banyak fungsi ke aplikasi Chat, lihat panduan berikut:
- Membuat kartu interaktif — Pesan kartu mendukung tata letak yang ditentukan, elemen UI interaktif seperti tombol, dan multimedia seperti gambar. Gunakan pesan kartu untuk menyajikan informasi mendetail, mengumpulkan informasi dari pengguna, dan memandu pengguna melakukan langkah berikutnya.
- Perintah garis miring dukungan — Perintah garis miring memungkinkan Anda mendaftarkan dan mengiklankan perintah tertentu yang dapat diberikan pengguna kepada aplikasi dengan mengetik perintah yang diawali dengan garis miring (
/
), seperti/help
. - Dialog peluncuran — Dialog adalah antarmuka berbasis kartu yang dapat dibuka aplikasi Anda untuk berinteraksi dengan pengguna. Beberapa kartu dapat dirangkai secara berurutan, yang membantu pengguna menyelesaikan proses multi-langkah, seperti mengisi data formulir.
Untuk mempelajari Google Chat API lebih lanjut, lihat dokumentasi referensi.