Panduan memulai aplikasi Chat Google Apps Script

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:

Arsitektur aplikasi Chat yang diimplementasikan dengan Apps Script.

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

  1. Pengguna mengirim pesan ke aplikasi Chat, baik dalam pesan langsung maupun dalam ruang Chat.
  2. Logika aplikasi Chat yang diimplementasikan di Apps Script, yang berada di Google Cloud, akan menerima dan memproses pesan.
  3. Secara opsional, logika aplikasi Chat dapat terintegrasi 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.
  • Memublikasikan aplikasi Chat.
  • Menguji aplikasi Chat.

Prasyarat

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.

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

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.

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

    Buka layar izin OAuth

  2. Pilih jenis pengguna untuk aplikasi Anda, lalu klik Buat.
  3. Lengkapi formulir pendaftaran aplikasi, lalu klik Simpan dan Lanjutkan.
  4. 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 menambahkan dan memverifikasi cakupan otorisasi yang diperlukan aplikasi Anda.

  5. Jika memilih Eksternal untuk jenis pengguna, tambahkan pengguna pengujian:
    1. Di bagian Pengguna uji coba, klik Tambahkan pengguna.
    2. Masukkan alamat email Anda dan pengguna pengujian yang diotorisasi lainnya, lalu klik Simpan dan Lanjutkan.
  6. 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}

  1. Buka halaman Memulai Apps Script.
  2. Klik template Chat App. 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. Buka project Cloud Anda di Google Cloud Console.
  2. Klik Setelan dan Utilitas > Setelan project.
  3. Salin Project number.

Menetapkan project Cloud project Apps Script

  1. Di project Apps Script aplikasi Chat, klik Project Settings Ikon untuk setelan project.
  2. Pada Google Cloud Platform (GCP) Project, klik Change project.
  3. Di GCP project number, tempel nomor project Google Cloud.
  4. 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:

  1. Pada project Apps Script aplikasi Chat, klik Deploy > Uji deployment.
  2. Salin Head deployment ID untuk digunakan di langkah berikutnya, lalu klik Done.

Memublikasikan aplikasi Chat

Memublikasikan aplikasi Chat dari Konsol Google Cloud.

  1. Di Konsol Google Cloud, telusuri Google Chat API, lalu klik Google Chat API.
  2. Klik Manage.
  3. Klik Configuration, lalu 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 Join spaces and group conversations.
    5. Di bagian Connection settings, pilih Apps Script project lalu tempelkan ID Deployment ke dalam kolom tersebut.
    6. Di bagian Visibilitas, pilih Orang dan grup tertentu di domain Anda, lalu masukkan email Anda.
  4. Klik Save dan muat ulang halaman.

  5. Di halaman konfigurasi, pada bagian App status, setel status ke Live - available to users.

  6. Klik Simpan.

Aplikasi Chat siap membalas pesan.

Menguji aplikasi Chat

  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 yang baru dengan aplikasi, ketik Hello, lalu tekan enter.

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.

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.