Halaman ini menjelaskan cara membuat dan mengirim pesan berbasis kartu sebagai aplikasi Google Chat. Kartu mendukung tata letak yang ditentukan, elemen UI interaktif seperti tombol, dan multimedia seperti gambar. Untuk mempelajari lebih lanjut cara menggunakan kartu, lihat Mendesain UI yang dinamis, interaktif, dan konsisten dengan kartu. Untuk mengetahui informasi selengkapnya tentang pesan, lihat Ringkasan pesan Google Chat.
Prasyarat
Node.js
- Akun Google Workspace dengan akses ke Google Chat.
- Aplikasi Chat. Untuk mem-build aplikasi Chat, ikuti panduan memulai ini.
Catatan: Contoh kode Node.js dalam panduan ini ditulis untuk dijalankan sebagai Google Cloud Function.
Python
- Akun Google Workspace dengan akses ke Google Chat.
- Aplikasi Chat. Untuk mem-build aplikasi Chat, ikuti panduan memulai ini.
Catatan: Contoh kode Python dalam panduan ini ditulis untuk dijalankan sebagai Google Cloud Function, menggunakan Python 3.9.
Apps Script
- Akun Google Workspace dengan akses ke Google Chat.
- Aplikasi Chat. Untuk mem-build aplikasi Chat, ikuti panduan memulai ini.
Buat pesan kartu
Bagian ini menjelaskan cara membuat pesan kartu dalam dua cara: dengan merespons interaksi pengguna dan memanggil Google Chat API secara asinkron.
Merespons pengguna
Aplikasi Chat dapat membuat pesan kartu untuk merespons interaksi pengguna, seperti saat pengguna mengirim pesan ke aplikasi Chat atau menambahkan aplikasi Chat ke suatu ruang. Untuk mempelajari lebih lanjut cara merespons interaksi pengguna, baca Menerima dan merespons peristiwa interaksi aplikasi Chat.
Dalam contoh ini, pengguna mengirim pesan ke aplikasi Chat dan aplikasi Chat merespons dengan mengirim pesan kartu yang menampilkan nama dan gambar avatar pengguna:
Node.js
Python
Apps Script
Memanggil Google Chat API
Berikut ini cara membuat pesan kartu dengan memanggil Google Chat API secara asinkron.
Pemanggilan Chat API secara asinkron memerlukan autentikasi. Karena hanya aplikasi Chat yang dapat membuat pesan kartu, aplikasi Chat harus menggunakan autentikasi aplikasi untuk membuat dan mengirim pesan kartu (aplikasi Chat tidak dapat menggunakan autentikasi pengguna untuk mengirim pesan kartu atas nama pengguna). Untuk mempelajari lebih lanjut, lihat Ringkasan autentikasi Google Chat.
Dalam contoh ini, Anda membuat pesan kartu berikut menggunakan autentikasi aplikasi:

Untuk menyiapkan autentikasi dan mempelajari cara membuat pesan secara asinkron, lihat panduan Chat API.
Python
- Di direktori kerja, buat file bernama
chat_create_card_message.py
. Sertakan kode berikut di
chat_create_card_message.py
:from httplib2 import Http from oauth2client.service_account import ServiceAccountCredentials from apiclient.discovery import build # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot'] # Specify service account details. CREDENTIALS = ServiceAccountCredentials.from_json_keyfile_name( 'credentials.json', SCOPES) # Build the URI and authenticate with the service account. chat = build('chat', 'v1', http=CREDENTIALS.authorize(Http())) # Create a Chat message. result = chat.spaces().messages().create( # The space to create the message in. # # Replace SPACE with a space name. # Obtain the space name from the spaces resource of Chat API, # or from a space's URL. parent='spaces/SPACE', # The message to create. body= { 'cardsV2': [{ 'cardId': 'createCardMessage', 'card': { 'header': { 'title': 'A Card Message!', 'subtitle': 'Created with Chat REST API', 'imageUrl': 'https://developers.google.com/chat/images/chat-product-icon.png', 'imageType': 'CIRCLE' }, 'sections': [ { 'widgets': [ { 'buttonList': { 'buttons': [ { 'text': 'Read the docs!', 'onClick': { 'openLink': { 'url': 'https://developers.google.com/chat' } } } ] } } ] } ] } }] } ).execute() print(result)
Dalam kode, ganti
SPACE
dengan nama ruang, yang dapat Anda peroleh dari metodespaces.list()
di Chat API, atau dari URL ruang.Di direktori kerja Anda, build dan jalankan contoh:
python3 chat_create_card_message.py
Untuk mempelajari lebih lanjut cara menangani pesan di Chat API, lihat hal berikut:
Memecahkan masalah
Saat aplikasi atau kartu Google Chat menampilkan error, antarmuka Chat akan menampilkan pesan yang menyatakan "Terjadi masalah". atau "Tidak dapat memproses permintaan Anda". Terkadang UI Chat tidak menampilkan pesan error apa pun, tetapi aplikasi atau kartu Chat memberikan hasil yang tidak diharapkan; misalnya, pesan kartu mungkin tidak 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 mendapatkan bantuan terkait melihat, men-debug, dan memperbaiki error, lihat Memecahkan masalah dan memperbaiki error Google Chat.
Topik terkait
- Membuka dialog interaktif: Membuat kartu yang terbuka di jendela.
- Membaca input data formulir oleh pengguna di kartu: Buat kartu yang memungkinkan pengguna memasukkan informasi, seperti kolom teks atau alat pilih tanggal.
- Memformat pesan: Pelajari cara memformat teks dalam pesan.
- Menerima pesan: Mendapatkan detail tentang pesan, seperti kapan pesan dikirim atau isinya.
- Cantumkan pesan: Melihat daftar pesan yang diberi nomor halaman dan dapat difilter dalam ruang.
- Perbarui pesan: Mengubah atribut pesan, seperti isi pesannya. Anda juga dapat menambahkan teks ke pesan kartu, atau kartu ke pesan teks.
- Menghapus pesan: Menghapus pesan dari ruang.