Panduan memulai aplikasi Chat Google Apps Script

Buat aplikasi Google Chat yang dapat Anda kirimi pesan secara langsung dan yang merespons dengan mengulangi pesan Anda.

Tujuan

• Siapkan lingkungan Anda.
• Siapkan skrip.
• Publikasikan aplikasi.
• Jalankan skrip.

Prasyarat

• Akun Google Workspace dengan akses ke Chat.
• Project Google Cloud.

Menyiapkan lingkungan Anda

Buka project Cloud Anda di Google Cloud Console

Jika belum terbuka, buka project Cloud yang ingin Anda gunakan untuk contoh ini:

1. Di Google Cloud Console, buka halaman Select a project.

   Memilih project Cloud

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

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 Google Cloud Console, aktifkan Google Chat API.

  Mengaktifkan 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 akan ditampilkan kepada pengguna dan peninjau aplikasi, serta mendaftarkan aplikasi agar dapat dipublikasikan nanti.

1. Di Google Cloud Console, buka Menu > APIs & Services > OAuth consent screen.

   Buka layar izin OAuth

2. Pilih jenis pengguna untuk aplikasi Anda, lalu klik Create.
3. Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.

4. Untuk saat ini, Anda dapat melewati proses penambahan cakupan dan mengklik Simpan dan Lanjutkan. Di masa mendatang, saat membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus menambahkan dan memverifikasi cakupan otorisasi yang diperlukan aplikasi.

5. Jika Anda memilih Eksternal untuk jenis pengguna, tambahkan pengguna pengujian:
   1. Di bagian Uji pengguna, klik Tambahkan pengguna.
   2. Masukkan alamat email Anda dan pengguna pengujian resmi lainnya, lalu klik Simpan dan Lanjutkan.
6. Tinjau ringkasan pendaftaran aplikasi Anda. Untuk membuat perubahan, klik Edit. Jika pendaftaran aplikasi sudah benar, klik Kembali ke Dasbor.

Menyiapkan skrip

Untuk menyiapkan skrip, gunakan template, lalu tetapkan project Cloud Anda di Apps Script.

Membuat skrip dari template

1. Buka halaman Memulai Apps Script.
2. Klik template Aplikasi Chat. Anda mungkin harus men-scroll ke bawah untuk melihat template ini.
3. Klik Untitled project, ketik Quickstart app, lalu klik Rename.

Menyalin nomor project Cloud

1. Buka project Cloud Anda di Google Cloud Console.
2. Klik Setelan dan Utilitas > Setelan project.
3. Salin Nomor project.

Menetapkan project Cloud pada project Apps Script

1. Di project Apps Script aplikasi Chat, klik Setelan Project .
2. Di bagian Project Google Cloud Platform (GCP), klik Ubah project.
3. Di bagian GCP project number, tempel nomor project Google Cloud.
4. Klik Set project.

Kini Anda memiliki kode aplikasi yang berfungsi dan dapat Anda coba (seperti yang dijelaskan dalam langkah-langkah berikut), lalu sesuaikan untuk memenuhi kebutuhan Anda.

Pastikan Anda login ke Akun Google yang benar saat membuka template 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, sehingga dapat digunakan pada langkah berikutnya.

Untuk mendapatkan ID deployment head, lakukan hal berikut:

1. Di project Apps Script aplikasi Chat, klik Deploy > Test deployment.
2. Salin ID deployment Head untuk digunakan di langkah berikutnya, lalu klik Selesai.

Memublikasikan aplikasi Chat

Publikasikan aplikasi Chat dari konsol Google Cloud.

1. Di Google Cloud Console, telusuri Google Chat API, lalu klik Google Chat API.
2. Klik Manage.

3. Klik Konfigurasi, lalu siapkan aplikasi Chat:

   1. Di kolom Nama aplikasi, masukkan Quickstart app.
   2. Pada kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. Di kolom Deskripsi, masukkan Quickstart app.
   4. Di bagian Fungsi, pilih Terima pesan 1:1 dan Gabung ke ruang dan percakapan grup.
   5. Di bagian setelan Connection, pilih Apps Script project dan tempel ID Deployment ke dalam kolom.
   6. Di bagian Izin, pilih Orang dan grup tertentu di domain Anda, lalu masukkan email Anda.

4. Klik Simpan, lalu muat ulang halaman.

5. Di halaman konfigurasi, di bagian Status aplikasi, setel status ke Live - tersedia untuk pengguna.

6. Klik Simpan.

Aplikasi Chat siap merespons pesan.

Menjalankan skrip

1. Buka Chat.
2. Kirim pesan langsung baru ke aplikasi dengan mengklik Mulai chat > Temukan aplikasi.
3. Di halaman Temukan aplikasi, telusuri Quickstart App.
4. Di samping Quickstart App, klik Chat.
5. Di pesan langsung baru dengan aplikasi, ketik Hello dan tekan enter.

Aplikasi ini berterima kasih karena telah menambahkannya dan mengulangi pesan Anda.

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 melakukan langkah berikutnya.
• Perintah garis miring dukungan–Perintah garis miring memungkinkan Anda mendaftarkan dan mengiklankan perintah tertentu yang dapat diberikan pengguna kepada aplikasi Anda dengan mengetik perintah yang diawali dengan garis miring (/), seperti /help.
• Dialog peluncuran–Dialog adalah antarmuka berbasis kartu jendela 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.