Kartu
Kartu adalah elemen UI yang dapat berisi widget UI seperti teks dan gambar.
Representasi JSON |
---|
{ "header": { object ( |
Kolom | |
---|---|
header
|
Header kartu. {i>Header<i} biasanya berisi judul dan gambar. |
sections[]
|
Bagian-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 memerlukan satu baris. Jika hanya judul yang ditentukan, judul akan mengisi kedua baris. |
subtitle
|
Subjudul header kartu. |
imageStyle
|
Jenis gambar (misalnya, batas persegi atau batas melingkar). |
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 penetapannya. Di semua platform, kartu memiliki lebar tetap yang sempit, sehingga saat ini properti tata letak tidak diperlukan (misalnya, float).
Representasi JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Kolom | |
---|---|
header
|
Header bagian. 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. |
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 merupakan
|
Kolom gabungan data . WidgetMarkup hanya dapat memiliki salah satu dari item berikut ini. Anda dapat menggunakan beberapa kolom
WidgetMarkup
untuk menampilkan lebih banyak item.
data
hanya dapat berupa salah satu dari yang berikut:
|
|
textParagraph
|
Tampilkan paragraf teks dalam widget ini. |
image
|
Tampilkan gambar di widget ini. |
keyValue
|
Tampilkan item nilai kunci di widget ini. |
TextParagraph
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 menetapkan tinggi yang tepat untuk gambar sembari menunggu dimuat. Fitur ini tidak dimaksudkan untuk mengganti rasio aspek bawaan gambar. Jika tidak disetel, server akan mengisinya dengan melakukan pengambilan data gambar. |
OnClick
Tindakan
onclick
(misalnya, membuka link).
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom gabungan
|
|
action
|
Tindakan formulir dipicu oleh tindakan
|
openLink
|
Tindakan
|
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 yang memicu pengiriman formulir. Informasi ini dipantulkan 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 disediakan saat metode tindakan dipanggil. Misalnya, pertimbangkan tiga tombol tunda: tunda sekarang, tunda satu hari, tunda minggu depan. Anda dapat menggunakan
action method = snooze()
, yang meneruskan jenis penundaan dan waktu tunda 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 atas. 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
|
Jika konten harus terdiri dari multi-garis. |
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
|
Kolom gabungan icons . Setidaknya salah satu ikon,
top_label
dan
bottom_label
harus ditentukan.
icons
hanya dapat berupa salah satu dari yang berikut:
|
|
icon
|
Nilai enum yang diganti oleh Chat API dengan gambar ikon yang sesuai. |
iconUrl
|
Ikon yang ditentukan oleh URL. |
Kolom gabungan control . Widget kontrol. Anda dapat menetapkan
button
atau
switch_widget , tetapi tidak keduanya.
control
hanya dapat berupa salah satu dari yang berikut:
|
|
button
|
Tombol yang bisa diklik untuk memicu tindakan. |
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 |
---|
{ // Union field |
Kolom | |
---|---|
Kolom gabungan
|
|
textButton
|
Tombol dengan teks dan
tindakan
|
imageButton
|
Tombol dengan gambar dan
tindakan
|
TextButton
Tombol dengan teks dan
tindakan
onclick
.
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
|
Kolom gabungan icons . Ikon dapat ditentukan melalui
Icon
enum
atau URL.
icons
hanya dapat berupa salah satu dari yang berikut:
|
|
icon
|
Ikon yang ditentukan oleh
|
iconUrl
|
Ikon yang ditentukan oleh URL. |
CardAction
Tindakan kartu adalah tindakan yang terkait dengan kartu. Untuk kartu invoice, tindakan yang umum dilakukan 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. |