Panduan memulai aplikasi Chat Google Apps Script

Membuat aplikasi Google Chat yang dapat Anda kirimi pesan secara langsung dan akan merespons pesan Anda.

Diagram berikut menunjukkan arsitektur dan pola pesan:

Pada diagram sebelumnya, pengguna berinteraksi dengan Apps Script Aplikasi Chat memiliki alur informasi berikut:

1. Pengguna mengirim pesan ke aplikasi Chat, baik dalam pesan langsung atau di ruang Chat.
2. Logika aplikasi Chat yang diimplementasikan di Apps Script, yang berada di Google Cloud, menerima dan memproses pesannya.
3. Secara opsional, logika aplikasi Chat dapat diintegrasikan dengan Layanan Google Workspace, seperti Kalender atau Spreadsheet, atau Layanan Google lainnya, seperti Google Maps atau YouTube.
4. Logika aplikasi Chat mengirimkan respons kembali ke Layanan aplikasi Chat di Chat.
5. Respons dikirimkan ke pengguna.

Tujuan

• Menyiapkan lingkungan Anda.
• Siapkan skrip.
• Publikasikan aplikasi Chat.
• Uji aplikasi Chat.

Prasyarat

• Sebuah Business atau Enterprise Akun Google Workspace yang memiliki akses ke Google Chat.
• Project Google Cloud. Untuk membuatnya, lihat Membuat 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:

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

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

  Mengaktifkan API

Mengonfigurasi layar izin OAuth

Semua aplikasi yang menggunakan OAuth 2.0 memerlukan konfigurasi layar izin. Mengonfigurasi layar izin OAuth aplikasi Anda menentukan apa yang ditampilkan kepada pengguna dan aplikasi peninjau, dan mendaftarkan aplikasi sehingga Anda bisa mempublikasikannya nanti.

1. Di konsol Google Cloud, buka Menu > API & Layanan > Layar izin OAuth.

   Buka layar izin OAuth

2. Untuk Jenis pengguna, pilih Internal, lalu klik Buat.
3. Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.

4. Untuk saat ini, Anda dapat melewati penambahan cakupan, lalu mengklik Simpan dan Lanjutkan. Pada masa mendatang, jika Anda membuat aplikasi untuk digunakan di luar organisasi Google Workspace, Anda harus mengubah Jenis pengguna menjadi Eksternal, lalu menambahkan cakupan otorisasi yang dibutuhkan aplikasi Anda.

5. Tinjau ringkasan pendaftaran aplikasi Anda. Untuk melakukan perubahan, klik Edit. Jika aplikasi pendaftaran tampak tidak bermasalah, klik Kembali ke Dasbor.

Menyiapkan skrip

Untuk menyiapkan skrip, gunakan template, lalu tetapkan Project cloud di Apps Script.

Membuat skrip dari template

1. Buka halaman Halaman Memulai Apps Script.
2. Klik template Aplikasi Chat. Anda mungkin harus men-scroll ke bawah untuk melihat {i>template<i} ini.
3. Klik Project tanpa judul, ketik Quickstart app, lalu klik Rename.

Salin nomor project Cloud

1. Di konsol Google Cloud, buka Menu &gt; IAM & Admin &gt; Setelan.

   Buka IAM & Setelan Admin

2. Di kolom Project number, salin nilainya.

Menetapkan project Cloud project Apps Script

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

Sekarang Anda memiliki kode aplikasi yang berfungsi dan dapat dicoba (seperti yang dijelaskan dalam langkah berikut) lalu menyesuaikannya untuk memenuhi kebutuhan Anda.

Pastikan bahwa Anda masuk ke Akun Google yang benar saat membuka Template Apps Script. Akun saat ini terkadang dapat beralih ke akun {i>default<i} Anda tanpa Anda menyadarinya.

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:

1. Di project Apps Script aplikasi Chat, Klik Deploy. &gt; Deployment pengujian.
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 kolom Konsol Google Cloud, telusuri Google Chat API, lalu klik Google Chat API.
2. Klik Manage.

3. Klik Configuration dan siapkan aplikasi Chat:

   1. Di kolom App name, masukkan Quickstart app.
   2. Di kolom Avatar URL, masukkan https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. Di kolom Description, masukkan Quickstart app.
   4. Di bagian Functions, pilih Receive 1:1 messages dan Bergabung ke ruang dan percakapan grup.
   5. Di bagian Connection settings, pilih Apps Script project.
   6. Di kolom ID Deployment, tempel ID deployment Head yang Anda disalin sebelumnya.
   7. Di bagian Visibilitas, pilih Orang dan grup tertentu di domain, lalu masukkan email Anda.

4. Klik Simpan.

Aplikasi Chat siap merespons pesan.

Menguji aplikasi Chat

Untuk menguji aplikasi Chat Anda, buka ruang pesan langsung dengan aplikasi Chat dan mengirim pesan:

1. Buka Google Chat menggunakan akun Google Workspace yang telah Anda yang diberikan ketika Anda menambahkan diri Anda sebagai penguji tepercaya.

   Buka Google Chat

2. Klik Chat baru.
3. Di kolom Tambahkan 1 orang atau lebih, ketik nama Aplikasi Chat.

4. Pilih aplikasi Chat Anda dari hasil yang ditampilkan. Iklan langsung pesan terbuka.

   Catatan:Jika Anda tidak melihat aplikasi Chat Anda dalam daftar hasil, pastikan Anda telah menyertakan akun Google Workspace di Visibilitas setelan Konfigurasi Chat API di Konsol Google Cloud.

5. Di pesan langsung baru dengan aplikasi, ketik Hello dan tekan enter.

   Aplikasi Chat berterima kasih karena Anda telah menambahkannya dan pesan Anda.

Untuk menambahkan penguji tepercaya dan mempelajari lebih lanjut pengujian fitur interaktif, lihat Menguji fitur interaktif untuk Aplikasi Google Chat.

Memecahkan masalah

Saat aplikasi Google Chat atau kartu menampilkan error, Antarmuka Chat menampilkan pesan yang bertuliskan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error apa pun, tetapi aplikasi Chat atau memberikan hasil yang tidak diharapkan; misalnya, pesan kartu mungkin tidak akan 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 bantuan melihat, men-debug, dan memperbaiki error, melihat Memecahkan masalah dan memperbaiki error Google Chat.

Pembersihan

Agar tidak menimbulkan biaya ke akun Google Cloud Anda untuk sumber daya yang digunakan dalam tutorial ini, sebaiknya Anda menghapus project Google Cloud.

Perhatian: Menghapus project memiliki efek berikut:

• Semua hal dalam project akan dihapus. Jika Anda menggunakan project yang ada untuk tutorial ini, saat menghapusnya, Anda juga akan menghapus semua pekerjaan lain yang telah Anda lakukan di project tersebut.
• Project ID kustom akan hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang masih ingin Anda gunakan pada masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL di appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus keseluruhan project.

Jika Anda berencana untuk mempelajari beberapa tutorial dan panduan memulai, menggunakan kembali project dapat membantu Anda agar tidak melampaui batas kuota project.

1. Di Konsol Google Cloud, buka halaman Manage resources. Klik Menu &gt; IAM & Admin &gt; Kelola Resource.

   Buka Resource Manager

2. Dalam daftar project, pilih project yang ingin Anda hapus, lalu klik Hapus .
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus menyelesaikan proyek tersebut.

Langkah berikutnya

• Buat kartu interaktif–Kartu mendukung tata letak yang ditentukan, elemen UI interaktif seperti tombol, dan multimedia seperti gambar. Gunakan pesan kartu untuk menyajikan informasi terperinci, mengumpulkan informasi dari pengguna, dan memandu pengguna untuk mengambil langkah selanjutnya.
• Mendukung perintah garis miring–Perintah garis miring memungkinkan Anda mendaftar dan mengiklankan perintah khusus yang dapat diberikan pengguna ke aplikasi Anda dengan mengetik perintah yang dimulai dengan garis miring (/), seperti /help.
• Launch dialogs–Dialog berjendela, berbasis kartu antarmuka yang dapat dibuka aplikasi Anda untuk berinteraksi dengan pengguna. Beberapa kartu dapat dirangkai secara berurutan, yang membantu pengguna menyelesaikan proses, seperti mengisi data formulir.
• Codelab: Siap membuat versi yang lebih canggih Aplikasi Chat? Lihat masukan Aplikasi Chat dari codelab Membuat aplikasi untuk Google Chat dengan Gemini.