Buat aplikasi Google Chat yang dapat Anda kirimi pesan secara langsung dan yang merespons dengan melakukan echo pesan.
Diagram berikut menunjukkan arsitektur dan pola pesan:
Pada diagram sebelumnya, pengguna yang berinteraksi dengan aplikasi Chat Apps Script memiliki alur informasi berikut:
- Pengguna mengirim pesan ke aplikasi Chat, baik dalam pesan langsung maupun dalam ruang Chat.
- Logika aplikasi Chat yang diimplementasikan di Apps Script, yang berada di Google Cloud, akan menerima dan memproses pesan.
- Secara opsional, logika aplikasi Chat dapat terintegrasi dengan layanan Google Workspace, seperti Kalender atau Spreadsheet, atau Layanan Google lainnya, seperti Google Maps atau YouTube.
- Logika aplikasi Chat mengirimkan respons kembali ke layanan aplikasi Chat di Chat.
- Respons dikirimkan ke pengguna.
Tujuan
- Menyiapkan lingkungan Anda.
- Siapkan skrip.
- Memublikasikan aplikasi Chat.
- Menguji aplikasi Chat.
Prasyarat
- Akun Google Workspace dengan akses ke Chat.
- Project Google Cloud.
Menyiapkan lingkungan Anda
Buka project Cloud Anda di konsol Google Cloud
Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:
- Di konsol Google Cloud, buka halaman Select a project.
- Pilih project Google Cloud yang ingin Anda gunakan. Atau, klik Buat project dan ikuti petunjuk di layar. Jika membuat project Google Cloud, Anda mungkin perlu mengaktifkan penagihan untuk project tersebut.
Mengaktifkan Chat API
Sebelum menggunakan Google API, Anda harus mengaktifkannya di project Google Cloud. Anda dapat mengaktifkan satu atau beberapa API dalam satu project Google Cloud.Di konsol Google Cloud, aktifkan Google Chat API.
Mengonfigurasi layar izin OAuth
Semua aplikasi yang menggunakan OAuth 2.0 memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth aplikasi Anda akan menentukan apa yang ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi agar dapat dipublikasikan nanti.
- Di konsol Google Cloud, buka Menu > APIs & Services > OAuth consent screen.
- Untuk Jenis pengguna, pilih Internal, lalu klik Buat.
- Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.
Untuk saat ini, Anda dapat melewati penambahan cakupan dan mengklik Simpan dan Lanjutkan. Pada masa mendatang, saat membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah User type menjadi External, lalu tambahkan cakupan otorisasi yang diperlukan aplikasi Anda.
- Tinjau ringkasan pendaftaran aplikasi Anda. Untuk melakukan perubahan, klik Edit. Jika pendaftaran aplikasi terlihat baik-baik saja, klik Back to Dashboard.
Menyiapkan skrip
Untuk menyiapkan skrip, gunakan template, lalu tetapkan project Cloud Anda di Apps Script.
Membuat skrip dari {i>template<i}
- Buka halaman Memulai Apps Script.
- Klik template Chat App. Anda mungkin harus men-scroll ke bawah untuk melihat {i>template<i} ini.
- Klik Project tanpa judul, ketik
Quickstart app
, lalu klik Rename.
Salin nomor project Cloud
- Di konsol Google Cloud, buka Menu > IAM & Admin > Settings.
- Di kolom Project number, salin nilainya.
Menetapkan project Cloud project Apps Script
- Di project Apps Script aplikasi Chat, klik Project Settings .
- Pada Google Cloud Platform (GCP) Project, klik Change project.
- Di GCP project number, tempel nomor project Google Cloud.
- Klik Set project.
Kini Anda memiliki kode aplikasi yang berfungsi yang dapat dicoba (seperti yang dijelaskan pada langkah-langkah berikut), lalu disesuaikan untuk memenuhi kebutuhan Anda.
Pastikan Anda login ke Akun Google yang benar saat membuka template Apps Script. Akun saat ini terkadang dapat beralih ke akun default tanpa Anda sadari.
Membuat deployment pengujian
Anda memerlukan ID deployment untuk project Apps Script ini, agar Anda dapat menggunakannya di langkah berikutnya.
Untuk mendapatkan ID deployment head, lakukan hal berikut:
- Pada project Apps Script aplikasi Chat, klik Deploy > Uji deployment.
- Salin Head deployment ID untuk digunakan di langkah berikutnya, lalu klik Done.
Memublikasikan aplikasi Chat
Memublikasikan aplikasi Chat dari Konsol Google Cloud.
- Di Konsol Google Cloud, telusuri
Google Chat API
, lalu klik Google Chat API. - Klik Manage.
Klik Configuration, lalu siapkan aplikasi Chat:
- Di kolom App name, masukkan
Quickstart app
. - Di kolom Avatar URL, masukkan
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Di kolom Description, masukkan
Quickstart app
. - Di bagian Functions, pilih Receive 1:1 messages dan Join spaces and group conversations.
- Di bagian Connection settings, pilih Apps Script project.
- Di kolom Deployment ID, tempel ID deployment Head yang sebelumnya Anda salin.
- Di bagian Visibilitas, pilih Orang dan grup tertentu di domain Anda, lalu masukkan email Anda.
- Di kolom App name, masukkan
Klik Save.
Aplikasi Chat siap membalas pesan.
Menguji aplikasi Chat
Untuk menguji aplikasi Chat Anda, buka ruang pesan langsung dengan aplikasi Chat dan kirim pesan:
Buka Google Chat menggunakan akun Google Workspace yang Anda berikan saat menambahkan diri Anda sebagai penguji tepercaya.
- Klik Chat baru.
- Di kolom Tambahkan 1 orang atau lebih, ketik nama aplikasi Chat Anda.
Pilih aplikasi Chat Anda dari hasil tersebut. Pesan langsung akan terbuka.
Di pesan langsung yang baru dengan aplikasi, ketik
Hello
, lalu tekanenter
.Aplikasi Chat berterima kasih karena Anda telah menambahkannya dan menggemakan pesan Anda.
Untuk menambahkan penguji tepercaya dan mempelajari lebih lanjut cara menguji fitur interaktif, lihat Menguji fitur interaktif untuk aplikasi Google Chat.
Memecahkan masalah
Saat aplikasi atau kartu Google Chat menampilkan error, antarmuka Chat akan menampilkan pesan yang menyatakan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error apa pun, tetapi aplikasi atau kartu Chat memberikan hasil yang tidak diharapkan. Misalnya, pesan kartu mungkin tidak muncul.
Meskipun pesan error mungkin tidak ditampilkan di UI Chat, pesan error deskriptif dan data log tersedia untuk membantu Anda memperbaiki error saat logging error untuk aplikasi Chat diaktifkan. Untuk mendapatkan bantuan dalam melihat, men-debug, dan memperbaiki error, lihat Memecahkan masalah dan memperbaiki error Google Chat.
Pembersihan
Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan dalam tutorial ini, sebaiknya hapus project Cloud.
- Pada Konsol Google Cloud, buka halaman Kelola resource Klik Menu > IAM & Admin > Manage Resources.
- Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Delete .
- Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.
Langkah berikutnya
- 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 untuk mengambil langkah berikutnya.
- Mendukung perintah garis miring–Perintah garis miring memungkinkan Anda mendaftarkan dan memberitahukan perintah khusus yang dapat diberikan pengguna kepada aplikasi Anda dengan mengetik perintah yang diawali dengan garis miring (
/
), seperti/help
. - Dialog peluncuran–Dialog adalah antarmuka berbasis kartu berjendela yang dapat dibuka aplikasi untuk berinteraksi dengan pengguna. Beberapa kartu dapat dirangkai secara berurutan, yang membantu pengguna menyelesaikan proses bertahap, seperti mengisi data formulir.
- Membangun aplikasi untuk Google Chat dengan Gemini. Codelab: Siap mem-build aplikasi Chat yang lebih canggih? Lihat masukan aplikasi Chat dari codelab