GSP250

Ringkasan

Bot Google Chat menyediakan titik akses yang mudah digunakan ke data dan layanan organisasi Anda. Pengguna dapat berkomunikasi dengan bot dalam pengalaman chat. Salah satu cara untuk membuat bot Google Chat adalah menggunakan Google Apps Script. Hal ini juga memberi Anda akses mudah ke layanan Google lainnya, seperti Drive, Gmail, Kalender, Dokumen, Spreadsheet, dan banyak lagi.

Di lab ini, Anda akan menggunakan Google Apps Script untuk membuat bot Google Chat sederhana sebagai pengantar cepat bot Google Chat.

Yang akan Anda lakukan

Di lab ini, Anda akan melakukan tugas berikut:

• Membuat aplikasi chat dari template dengan pengendali peristiwa yang sudah terisi.
• Mengonfigurasi dan memublikasikan bot Google Chat.

Penyiapan dan persyaratan

Sebelum mengklik tombol Start Lab

Baca petunjuk ini. Lab memiliki timer dan Anda tidak dapat menjedanya. Timer yang dimulai saat Anda mengklik Start Lab akan menampilkan durasi ketersediaan resource Google Cloud untuk Anda.

Lab interaktif ini dapat Anda gunakan untuk melakukan aktivitas lab di lingkungan cloud sungguhan, bukan di lingkungan demo atau simulasi. Untuk mengakses lab ini, Anda akan diberi kredensial baru yang bersifat sementara dan dapat digunakan untuk login serta mengakses Google Cloud selama durasi lab.

Untuk menyelesaikan lab ini, Anda memerlukan:

• Akses ke browser internet standar (disarankan browser Chrome).

• Waktu untuk menyelesaikan lab. Ingat, setelah dimulai, lab tidak dapat dijeda.

Cara memulai lab dan login ke Google Cloud Console

1. Klik tombol Start Lab. Jika Anda perlu membayar lab, dialog akan terbuka untuk memilih metode pembayaran. Di sebelah kiri ada panel Lab Details yang berisi hal-hal berikut:

   • Tombol Open Google Cloud console
   • Waktu tersisa
   • Kredensial sementara yang harus Anda gunakan untuk lab ini
   • Informasi lain, jika diperlukan, untuk menyelesaikan lab ini

2. Klik Open Google Cloud console (atau klik kanan dan pilih Open Link in Incognito Window jika Anda menjalankan browser Chrome).

   Lab akan menjalankan resource, lalu membuka tab lain yang menampilkan halaman Sign in.

   Tips: Atur tab di jendela terpisah secara berdampingan.

   Catatan: Jika Anda melihat dialog Choose an account, klik Use Another Account.

3. Jika perlu, salin Username di bawah dan tempel ke dialog Sign in.

   {{{user_0.username | "Username"}}}

   Anda juga dapat menemukan Username di panel Lab Details.

4. Klik Next.

5. Salin Password di bawah dan tempel ke dialog Welcome.

   {{{user_0.password | "Password"}}}

   Anda juga dapat menemukan Password di panel Lab Details.

6. Klik Next.

   Penting: Anda harus menggunakan kredensial yang diberikan lab. Jangan menggunakan kredensial akun Google Cloud Anda. Catatan: Menggunakan akun Google Cloud sendiri untuk lab ini dapat dikenai biaya tambahan.

7. Klik halaman berikutnya:

   • Setujui persyaratan dan ketentuan.
   • Jangan tambahkan opsi pemulihan atau autentikasi 2 langkah (karena ini akun sementara).
   • Jangan mendaftar uji coba gratis.

Setelah beberapa saat, Konsol Google Cloud akan terbuka di tab ini.

Catatan: Untuk mengakses produk dan layanan Google Cloud, klik Navigation menu atau ketik nama layanan atau produk di kolom Search.

Tugas 1. Membuat aplikasi chat dari template

Untuk mengimplementasikan bot Anda, buat project Google Apps Script baru menggunakan template aplikasi Chat.

1. Klik link halaman beranda Google Apps Script ini untuk membuka editor online Google Apps Script.

2. Di bagian Google Workspace add-on starters, klik Chat app (Intermediate version).

3. Klik Untitled project (nama saat ini).

4. Di dialog Edit project name, ganti nama project menjadi Friendly Bot, lalu klik Rename.

Peristiwa di Google Chat

Sebagian besar interaksi bot Apps Script dengan Google Chat didorong oleh peristiwa. Interaksi antara pengguna, bot, dan Google Chat biasanya mengikuti urutan tertentu.

1. Pengguna memulai tindakan, seperti menambahkan bot ke ruang, memulai pesan langsung (DM) dengan bot, atau menghapus bot dari ruang.
2. Tindakan tersebut memunculkan peristiwa yang ditujukan untuk bot di Google Chat.
3. Google Chat memanggil pengendali peristiwa terkait yang ditentukan dalam skrip bot.

Google Chat memunculkan empat peristiwa yang dapat direspons oleh bot Apps Script Anda:

• ADDED_TO_SPACE: Peristiwa ini terjadi saat pengguna manusia menambahkan bot ke ruang atau DM. Di Apps Script, Anda menentukan fungsi onAddedToSpace() untuk menangani peristiwa ini.
• REMOVED_FROM_SPACE: Peristiwa ini terjadi saat pengguna menghapus bot dari ruang atau DM. Peristiwa ini tidak memposting respons kembali ke Google Chat. Di Apps Script, Anda menentukan fungsi onRemovedFromSpace() untuk menangani peristiwa ini.
• MESSAGE: Peristiwa ini terjadi saat pengguna mengirim pesan ke bot, secara langsung di DM ataupun sebagai @sebutan di ruang. Di Apps Script, Anda menentukan fungsi onMessage() untuk merespons peristiwa ini.

Meninjau kode untuk pengendali peristiwa MESSAGE

Template Aplikasi Chat telah mengisi file kode yang berisi pengendali peristiwa.

• Klik file Code.gs untuk meninjau pengendali peristiwa yang sudah diisi sebelumnya.

Perhatikan pengendali peristiwa untuk peristiwa MESSAGE, ADDED_TO_SPACE, dan REMOVE_FROM_SPACE, yang menjalankan fungsi spesifik yang disebutkan sebelumnya untuk menyelesaikan berbagai tugas, seperti merespons pesan pengguna di Google Chat.

Tugas 2. Memublikasikan dan menguji bot chat

Sebelum dapat menjalankan dan menguji bot, Google Chat API harus diaktifkan untuk project Google Cloud Anda, dan bot Anda harus dipublikasikan.

Dalam tugas ini, Anda akan menyelesaikan berbagai langkah konfigurasi agar dapat memublikasikan bot, termasuk mengonfigurasi layar izin OAuth, memperbarui aplikasi Apps Script untuk mereferensikan project Google Cloud yang sesuai, dan memperbarui konfigurasi Google Chat API untuk memublikasikan bot untuk pengujian.

Mengonfigurasi layar izin OAuth

1. Di Konsol Google Cloud, klik Navigation menu () di kiri atas, lalu buka APIs & Services > OAuth consent screen.

2. Klik Get Started.

3. Untuk halaman Project configuration, untuk App Information, konfigurasi hal berikut, lalu klik Next:

4. Untuk Audience, pilih Internal, lalu klik Next.

5. Untuk Contact Information, berikan alamat email , lalu klik Next.

6. Setujui kebijakan, lalu klik Continue. Setelah itu, klik Create.

Klik Check my progress untuk memverifikasi tujuan.

Mengidentifikasi nomor project Google Cloud dan mengupdate aplikasi Apps Script untuk mereferensikannya

1. Di Navigation menu (), klik Cloud Overview > Dashboard.

2. Di dasbor, temukan bagian Project Info.

3. Catat Project number untuk digunakan pada langkah berikutnya guna mengonfigurasi project Anda.

4. Kembali ke editor Apps Script, lalu buka Project Settings untuk project Friendly Bot ().

5. Pada Google Cloud Platform (GCP) Project, klik Change project.

6. Untuk GCP Project number, masukkan nomor project yang Anda salin sebelumnya. Lalu, klik Set project.

Mengonfigurasi dan memublikasikan bot chat

1. Di editor Apps Script, dapatkan Head Deployment ID untuk deployment pengujian dengan mengklik Deploy > Test Deployments (kanan atas layar), lalu mengklik Copy di samping Head Deployment ID.

2. Di Konsol Google Cloud, buka Navigation Menu () > APIs & Services > Library.

3. Di Library, telusuri Google Chat API, lalu pilih API dari daftar hasil.

Google Chat API seharusnya sudah diaktifkan di project ini. Jika belum diaktifkan, klik Enable.

4. Klik Manage, lalu klik tab Configuration untuk Google Chat API.

5. Dalam dialog Configuration, tetapkan nilai berikut dalam kolom terkait:

6. Klik Save.

7. Setelah perubahan disimpan, scroll ke bagian atas dialog Configuration untuk memperbarui App Status menjadi LIVE – available to users.

Anda mungkin harus memuat ulang halaman untuk melihat kolom App Status. Jika nilai App Status sudah ditetapkan ke LIVE – available to users, Anda dapat mempertahankan nilai tersebut, tetapi pastikan untuk menyimpan halaman lagi di langkah berikutnya.

8. Klik Save sekali lagi.

Menguji bot chat

Anda telah mencapai bagian terakhir untuk menguji bot Anda di Google Chat dengan menyelesaikan langkah-langkah berikut.

1. Klik link Google Chat untuk membuka Google Chat.

2. Pilih Mulai chat.

3. Telusuri Friendly bot.

4. Dari hasil, pilih Friendly Bot (bot lab Apps Script) yang Anda buat untuk memulai percakapan.

Saat rangkaian pesan langsung terbuka, Anda akan melihat pesan dari bot yang berterima kasih kepada Anda karena telah menambahkannya ke DM:

Terima kasih telah menambahkan saya ke pesan langsung, siswa XXXXX!

Respons ini dimulai oleh fungsi bernama onAddedToSpace, yang merespons peristiwa spesifik saat bot ditambahkan ke ruang chat.

5. Terakhir, masukkan pesan untuk bot, seperti "Halo bot!".

Anda akan melihat pesan dari bot yang mengulangi pesan Anda, seperti:

Anda mengatakan "Halo bot!"

Respons ini dimulai oleh fungsi bernama onMessage, yang merespons peristiwa spesifik saat pengguna mengirim pesan langsung ke bot.

Selamat!

Anda telah membuat bot Google Chat yang merespons pesan pengguna dengan cepat.

Langkah berikutnya/Pelajari lebih lanjut

• Lihat hal lain yang dapat Anda lakukan dengan Workspace:
  • Google Apps Script: Mengakses Google Spreadsheet, Maps & Gmail dalam 4 Baris Kode
• Lihat referensi berguna berikut:
  • Situs dokumentasi Google Chat
  • Panduan memulai bot Apps Script
  • Membuat bot baru
  • Memublikasikan bot
  • Membuat kartu interaktif
  • Referensi kartu
  • Referensi objek peristiwa
  • Referensi layanan lanjutan Gmail
  • Referensi Calendar Apps Script API
  • Pusat Pembelajaran Google Workspace

Sertifikasi dan pelatihan Google Cloud

...membantu Anda mengoptimalkan teknologi Google Cloud. Kelas kami mencakup keterampilan teknis dan praktik terbaik untuk membantu Anda memahami dengan cepat dan melanjutkan proses pembelajaran. Kami menawarkan pelatihan tingkat dasar hingga lanjutan dengan opsi on demand, live, dan virtual untuk menyesuaikan dengan jadwal Anda yang sibuk. Sertifikasi membantu Anda memvalidasi dan membuktikan keterampilan serta keahlian Anda dalam teknologi Google Cloud.

Manual Terakhir Diperbarui pada 18 Agustus 2025

Lab Terakhir Diuji pada 18 Agustus 2025

Hak cipta 2026 Google LLC. Semua hak dilindungi undang-undang. Google dan logo Google adalah merek dagang dari Google LLC. Semua nama perusahaan dan produk lain mungkin adalah merek dagang masing-masing perusahaan yang bersangkutan.