Halaman ini menjelaskan cara membuat beranda untuk Aplikasi Google Chat. Beranda aplikasi adalah antarmuka kartu yang dapat disesuaikan yang dikirim aplikasi Chat kepada pengguna saat mereka membuka dengan aplikasi Chat.
Sebagai contoh, Anda dapat mengkonfigurasi pesan kartu beranda aplikasi guna menyertakan kiat untuk berinteraksi dengan aplikasi Chat menggunakan perintah garis miring. Untuk pengguna akhir, beranda aplikasi adalah hanya tersedia di pesan langsung aplikasi Chat jika pengembang aplikasi mengaktifkan fitur tersebut.
Gunakan Card Builder untuk mendesain dan melihat pratinjau pesan kartu JSON untuk aplikasi Chat:
Membuka Card BuilderPrasyarat
Python
Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.
Apps Script
Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif di Apps Script, selesaikan panduan memulai ini.
Node.js
Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.
Java
Aplikasi Google Chat yang diaktifkan untuk fitur interaktif. Untuk membuat aplikasi Chat interaktif menggunakan layanan HTTP, selesaikan panduan memulai ini.
Mengonfigurasi Chat API
Untuk mendukung app home, Anda harus memperbarui konfigurasi Chat API di Konsol Google Cloud.
Python
Di Konsol Google Cloud, buka Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API.
Klik Manage, lalu klik tab Configuration.
Pilih kotak centang Support App Home.
Di kolom URL Beranda Aplikasi, tambahkan URL. Nilai ini biasanya sama URL sebagai URL Aplikasi. URL ini dipanggil untuk Peristiwa
APP_HOME
.Klik Simpan.
Apps Script
Di Konsol Google Cloud, buka Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API.
Klik Manage, lalu klik tab Configuration.
Pilih kotak centang Support App Home.
Klik Simpan.
Node.js
Di Konsol Google Cloud, buka Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API.
Klik Manage, lalu klik tab Configuration.
Pilih kotak centang Support App Home.
Di kolom URL Beranda Aplikasi, tambahkan URL. Nilai ini biasanya sama URL sebagai URL Aplikasi. URL ini dipanggil untuk Peristiwa
APP_HOME
.Klik Simpan.
Java
Di Konsol Google Cloud, buka Menu > Produk lainnya > Google Workspace > Library Produk > Google Chat API.
Klik Manage, lalu klik tab Configuration.
Pilih kotak centang Support App Home.
Di kolom URL Beranda Aplikasi, tambahkan URL. Nilai ini biasanya sama URL sebagai URL Aplikasi. URL ini dipanggil untuk Peristiwa
APP_HOME
.Klik Simpan.
Mem-build aplikasi utama
Kartu layar utama aplikasi dimulai saat pengguna membuka pesan langsung dari aplikasi Chat dan dapat diupdate sebagai respons dari peristiwa interaktif seperti klik tombol, pengiriman formulir, atau penutupan dialog.
Pada contoh berikut, aplikasi Chat menampilkan kartu beranda aplikasi awal yang menampilkan waktu kartu dibuat dan tombol. Saat pengguna mengklik tombol tersebut, aplikasi Chat menampilkan kartu yang diperbarui yang menunjukkan waktu pembuatan kartu yang diperbarui.
Membuat kartu awal untuk layar utama aplikasi
Untuk membangun beranda aplikasi, aplikasi Chat harus menangani
APP_HOME
peristiwa interaksi dan menampilkan instance
RenderActions
dengan navigasi pushCard
.
Python
Apps Script
Implementasikan fungsi onAppHome
yang dipanggil setelah semua peristiwa APP_HOME
:
Contoh ini mengirimkan pesan kartu dengan mengembalikan JSON kartu. Anda juga dapat menggunakan Layanan kartu Apps Script.
Node.js
Java
Memperbarui kartu beranda aplikasi
Jika kartu beranda aplikasi awal Anda berisi widget interaktif, seperti tombol
atau input pilihan, aplikasi Chat Anda harus menangani
peristiwa interaksi terkait dengan menampilkan instance
RenderActions
dengan navigasi updateCard
. Untuk mempelajari lebih lanjut
cara menangani
widget, lihat
Memproses informasi yang dimasukkan oleh pengguna.
Python
Apps Script
Contoh ini mengirimkan pesan kartu dengan mengembalikan JSON kartu. Anda juga dapat menggunakan Layanan kartu Apps Script.
Node.js
Java
Batasan
Secara umum,
navigation
sama dengan
tidak tersedia untuk aplikasi Chat. Anda tidak dapat menampilkan tumpukan kartu.
Hanya pushCard
(untuk respons awal) dan updateCard
(untuk update) yang
yang tersedia untuk aplikasi Chat.
Topik terkait
- Lihat contoh aplikasi Chat yang menggunakan layar utama aplikasi.
Untuk membuka dialog, gunakan interaksi
OPEN_DIALOG
. Untuk informasi selengkapnya, lihat Buka dialog sebagai respons terhadap kartu layar utama aplikasi.Untuk menutup dialog, gunakan interaksi
CLOSE_DIALOG
untuk menutup dialog dan kembali ke kartu beranda aplikasi atau gunakanCLOSE_DIALOG_EXECUTE
untuk menutup dialog dan memuat ulang kartu beranda aplikasi. Sebagai informasi selengkapnya, lihat Merespons dialog untuk kartu layar utama aplikasi.Untuk contoh cara menggunakan layar utama aplikasi, lihat aplikasi Chat pengelolaan masalah di codelab Membuat aplikasi untuk Google Chat dengan Gemini.