Kartu
Kartu adalah elemen UI yang dapat berisi widget UI seperti teks dan gambar.
| Representasi JSON |
|---|
{ "header": { object ( |
| Kolom | |
|---|---|
header
|
Header kartu. Header biasanya berisi judul dan gambar. |
sections[]
|
Bagian dipisahkan oleh garis pemisah. |
cardActions[]
|
Tindakan kartu ini. |
name
|
Nama kartu. |
CardHeader
| Representasi JSON |
|---|
{
"title": string,
"subtitle": string,
"imageStyle": enum ( |
| Kolom | |
|---|---|
title
|
Judul harus ditentukan. Header memiliki tinggi tetap: jika judul dan subtitel ditentukan, masing-masing akan menggunakan satu baris. Jika hanya judul yang ditentukan, judul tersebut akan menggunakan kedua baris. |
subtitle
|
Subjudul header kartu. |
imageStyle
|
Jenis gambar (misalnya, batas persegi atau batas lingkaran). |
imageUrl
|
URL gambar di header kartu. |
ImageStyle
| Enum | |
|---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Batas persegi. |
AVATAR
|
Batas lingkaran. |
Bagian
Bagian berisi kumpulan widget yang dirender (secara vertikal) sesuai urutan yang ditentukan. Di semua platform, kartu memiliki lebar tetap yang sempit, sehingga saat ini tidak diperlukan properti tata letak (misalnya, float).
| Representasi JSON |
|---|
{
"header": string,
"widgets": [
{
object ( |
| Kolom | |
|---|---|
header
|
Header bagian. Teks yang diformat didukung. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
widgets[]
|
Bagian harus berisi setidaknya satu widget. |
WidgetMarkup
Widget adalah elemen UI yang menampilkan teks dan gambar.
| Representasi JSON |
|---|
{ "buttons": [ { object ( |
| Kolom | |
|---|---|
buttons[]
|
Daftar tombol. Tombol juga
|
WidgetMarkup
hanya dapat memiliki salah satu item berikut. Anda dapat menggunakan beberapa kolom WidgetMarkup untuk menampilkan lebih banyak item. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
|
|
textParagraph
|
Menampilkan paragraf teks di widget ini. |
image
|
Menampilkan gambar di widget ini. |
keyValue
|
Menampilkan item nilai kunci di widget ini. |
| Akhir kolom yang saling eksklusif. | |
TextParagraph
Satu paragraf teks. Teks berformat didukung. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.
| Representasi JSON |
|---|
{ "text": string } |
| Kolom | |
|---|---|
text
|
|
Gambar
Gambar yang ditentukan oleh URL dan dapat memiliki tindakan
onclick.
| Representasi JSON |
|---|
{
"imageUrl": string,
"onClick": {
object ( |
| Kolom | |
|---|---|
imageUrl
|
URL gambar. |
onClick
|
Tindakan
|
aspectRatio
|
Rasio aspek gambar ini (lebar dan tinggi). Kolom ini memungkinkan Anda mencadangkan tinggi yang tepat untuk gambar sambil menunggu gambar dimuat. Atribut ini tidak dimaksudkan untuk mengganti rasio aspek bawaan gambar. Jika tidak ditetapkan, server akan mengisinya dengan mengambil gambar terlebih dahulu. |
OnClick
Tindakan
onclick
(misalnya, membuka link).
| Representasi JSON |
|---|
{ "action": { object ( |
| Kolom | |
|---|---|
| Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
action
|
Tindakan formulir dipicu oleh tindakan
|
openLink
|
Tindakan
|
| Akhir kolom yang saling eksklusif. | |
FormAction
Tindakan formulir menjelaskan perilaku saat formulir dikirimkan. Misalnya, Anda dapat memanggil Apps Script untuk menangani formulir.
| Representasi JSON |
|---|
{
"actionMethodName": string,
"parameters": [
{
object ( |
| Kolom | |
|---|---|
actionMethodName
|
Nama metode digunakan untuk mengidentifikasi bagian formulir mana yang memicu pengiriman formulir. Informasi ini akan ditampilkan kembali ke aplikasi Chat sebagai bagian dari peristiwa klik kartu. Anda dapat menggunakan nama metode yang sama untuk beberapa elemen yang memicu perilaku umum. |
parameters[]
|
Daftar parameter tindakan. |
ActionParameter
Daftar parameter string yang akan diberikan saat metode tindakan dipanggil. Misalnya, pertimbangkan tiga tombol tunda: tunda sekarang, tunda satu hari, tunda minggu depan. Anda dapat menggunakan
action method = snooze(), dengan meneruskan jenis snooze dan waktu snooze dalam daftar parameter string.
| Representasi JSON |
|---|
{ "key": string, "value": string } |
| Kolom | |
|---|---|
key
|
Nama parameter untuk skrip tindakan. |
value
|
Nilai parameter. |
OpenLink
Link yang membuka jendela baru.
| Representasi JSON |
|---|
{ "url": string } |
| Kolom | |
|---|---|
url
|
URL yang akan dibuka. |
KeyValue
Elemen UI berisi kunci (label) dan nilai (konten). Elemen ini juga dapat berisi beberapa tindakan seperti
tombol
onclick.
| Representasi JSON |
|---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
| Kolom | |
|---|---|
topLabel
|
Teks label teratas. Teks berformat didukung. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
content
|
Teks konten. Teks berformat didukung dan selalu diperlukan. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
contentMultiline
|
Apakah konten harus berupa multibaris. |
bottomLabel
|
Teks label bawah. Teks berformat didukung. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace. |
onClick
|
Tindakan
|
Setidaknya salah satu ikon,
top_label
dan
bottom_label
harus ditentukan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
|
|
icon
|
Nilai enum yang diganti oleh Chat API dengan gambar ikon yang sesuai. |
iconUrl
|
Ikon yang ditentukan oleh URL. |
| Akhir kolom yang saling eksklusif. | |
Widget kontrol. Anda dapat menetapkan
button
atau
switch_widget, tetapi tidak keduanya. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
|
|
button
|
Tombol yang dapat diklik untuk memicu tindakan. |
| Akhir kolom yang saling eksklusif. | |
Ikon
Kumpulan ikon yang didukung.
| Enum | |
|---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
|
Tombol
Tombol. Dapat berupa tombol teks atau tombol gambar.
| Representasi JSON |
|---|
{ "textButton": { object ( |
| Kolom | |
|---|---|
| Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons: | |
textButton
|
Tombol dengan teks dan
|
imageButton
|
Tombol dengan gambar dan tindakan
|
| Akhir kolom yang saling eksklusif. | |
TextButton
Tombol dengan teks dan
onclick
tindakan.
| Representasi JSON |
|---|
{
"text": string,
"onClick": {
object ( |
| Kolom | |
|---|---|
text
|
Teks tombol. |
onClick
|
Tindakan
|
ImageButton
Tombol gambar dengan tindakan
onclick.
| Representasi JSON |
|---|
{ "onClick": { object ( |
| Kolom | |
|---|---|
onClick
|
Tindakan
|
name
|
Nama
|
Ikon dapat ditentukan oleh
Icon
enum
atau URL. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
|
|
icon
|
Ikon yang ditentukan oleh
|
iconUrl
|
Ikon yang ditentukan oleh URL. |
| Akhir kolom yang saling eksklusif. | |
CardAction
Tindakan kartu adalah tindakan yang terkait dengan kartu. Untuk kartu invoice, tindakan umumnya adalah: menghapus invoice, mengirim invoice melalui email, atau membuka invoice di browser.
Tidak didukung oleh aplikasi Google Chat.
| Representasi JSON |
|---|
{
"actionLabel": string,
"onClick": {
object ( |
| Kolom | |
|---|---|
actionLabel
|
Label yang digunakan untuk ditampilkan di item menu tindakan. |
onClick
|
Tindakan onclick untuk item tindakan ini. |