Halaman ini memberikan ringkasan tentang cara mem-build add-on Google Workspace yang memperluas Google Chat.
Add-on Google Workspace yang memperluas Chat dapat membantu pengguna melakukan salah satu hal berikut:
- Lihat pratinjau link dari pesan Chat, dan lakukan tindakan tanpa keluar dari percakapan.
- Mengotomatiskan atau melakukan tugas di seluruh aplikasi Google Workspace.
- Menerima pemberitahuan atau notifikasi tentang alat atau layanan eksternal.
Cara kerja add-on Google Workspace di Chat
Di Chat, add-on akan muncul kepada pengguna sebagai aplikasi Google Chat. Untuk berinteraksi dengan pengguna, aplikasi Chat dapat melakukan hal berikut:
- Kirim pesan yang berisi teks, kartu, dan elemen UI interaktif.
- Merespons perintah garis miring.
- Buka dialog untuk membantu pengguna menyelesaikan proses multi-langkah, seperti mengisi data formulir.
- Lihat pratinjau link dalam pesan dengan melampirkan kartu yang berisi informasi bermanfaat yang memungkinkan pengguna mengambil tindakan langsung dari percakapan.
Mulai
Untuk mulai mem-build add-on Google Workspace yang berfungsi di Chat, lihat dokumentasi berikut:
- Coba panduan memulai untuk mem-build aplikasi Chat dasar menggunakan Google Apps Script atau layanan HTTP.
- Mengonfigurasi aplikasi Chat dan fitur interaktifnya menggunakan Chat API.
- Pelajari cara mem-build antarmuka Chat menggunakan pemicu, tindakan, dan objek peristiwa add-on.
Batasan dan masalah umum
Fitur Chat dan add-on berikut tidak tersedia:
- Dialogflow dan Pub/Sub. Anda harus membuat add-on yang memperluas Chat menggunakan Apps Script atau layanan HTTP.
- Layanan Kartu Apps Script. Untuk menggunakan tindakan Chat dan membuat kartu, tampilkan objek JSON. Misalnya, lihat Membuka dialog interaktif dan Melihat pratinjau link.
- Kartu otorisasi kustom. Untuk mengautentikasi dan memberikan otorisasi ke layanan Anda dari Chat, aplikasi Chat harus menampilkan kartu otorisasi dasar.
- Halaman beranda add-on di sidebar Chat. Jika Anda telah mengonfigurasi pemicu halaman beranda untuk add-on, halaman beranda hanya akan muncul di sidebar aplikasi Google Workspace lainnya yang diperluas oleh add-on Anda.
- Halaman beranda aplikasi Chat, yang muncul di tab Beranda pesan langsung dengan aplikasi Chat.
Jika Anda mengupdate add-on Google Workspace yang ada, pertimbangkan persyaratan konfigurasi berikut untuk aplikasi Chat:
- Setelan penginstalan Google Workspace Marketplace harus mengizinkan pengguna dan administrator Google Workspace untuk menginstal add-on.
- Semua setelan konfigurasi umum dalam
manifes
add-on (
addons.common) akan diabaikan di Chat. Untuk mengonfigurasi add-on agar berfungsi di Chat, Anda harus mengaktifkan dan mengonfigurasi Chat API. Untuk mengetahui langkah-langkahnya, lihat Mengonfigurasi aplikasi Google Chat. - Jika mem-build dengan layanan HTTP, Anda harus mengaktifkan
Google Workspace add-ons API. Resource REST
deploymentdanprojecthanya berlaku untuk deployment add-on di aplikasi Google Workspace lainnya. - Untuk men-deploy dan menguji add-on di Chat, Anda harus menggunakan setelan Visibilitas Chat API. Semua setelan visibilitas atau pengujian yang telah Anda konfigurasikan di Google Workspace Marketplace SDK akan diabaikan. Untuk men-deploy versi pengujian add-on di Chat, lihat Menguji fitur interaktif untuk aplikasi Google Chat dalam dokumentasi Chat API.
- Jika add-on dipublikasikan ke Google Workspace Marketplace, Anda tidak dapat menyimpan draf perubahan apa pun pada setelan konfigurasi Google Chat API. Saat Anda memperbarui setelan konfigurasi Chat API, aplikasi Chat yang diupdate akan langsung tersedia untuk semua pengguna yang ada. Untuk memperbarui listingan Marketplace, Anda dapat membuat draf sebelum mengirimkan perubahan apa pun.