Cards v1

Kartu

Kartu adalah elemen UI yang dapat berisi widget UI seperti teks dan gambar.

Representasi JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string
}
Kolom
header

object (CardHeader)

Header kartu. Header biasanya berisi judul dan gambar.

sections[]

object (Section)

Bagian dipisahkan oleh pemisah garis.

cardActions[]

object (CardAction)

Tindakan kartu ini.

name

string

Nama kartu.

CardHeader

Representasi JSON 
{
  "title": string,
  "subtitle": string,
  "imageStyle": enum (ImageStyle),
  "imageUrl": string
}
Kolom
title

string

Judul harus ditentukan. Header memiliki tinggi tetap: jika judul dan subtitel ditentukan, masing-masing akan menempati satu baris. Jika hanya judul yang ditentukan, judul akan menempati kedua baris.

subtitle

string

Subjudul header kartu.

imageStyle

enum (ImageStyle)

Jenis gambar (misalnya, batas persegi atau batas lingkaran).

imageUrl

string

URL gambar di header kartu.

ImageStyle

Enum
IMAGE_STYLE_UNSPECIFIED
IMAGE Batas persegi.
AVATAR Batas melingkar.

Bagian

Bagian berisi kumpulan widget yang dirender (secara vertikal) dalam 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 (WidgetMarkup)
    }
  ]
}
Kolom
header

string

Header bagian. Teks berformat didukung. Untuk informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

widgets[]

object (WidgetMarkup)

Bagian harus berisi minimal satu widget.

WidgetMarkup

Widget adalah elemen UI yang menyajikan teks dan gambar.

Representasi JSON 
{
  "buttons": [
    {
      object (Button)
    }
  ],

  // Union field data can be only one of the following:
  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "keyValue": {
    object (KeyValue)
  }
  // End of list of possible types for union field data.
}
Kolom
buttons[]

object (Button)

Daftar tombol. Tombol juga oneof data dan hanya salah satu kolom ini yang perlu ditetapkan.

Kolom union data. WidgetMarkup hanya dapat memiliki salah satu item berikut. Anda dapat menggunakan beberapa kolom WidgetMarkup untuk menampilkan lebih banyak item. data hanya dapat berupa salah satu dari yang berikut:
textParagraph

object (TextParagraph)

Menampilkan paragraf teks di widget ini.

image

object (Image)

Menampilkan gambar di widget ini.

keyValue

object (KeyValue)

Tampilkan item nilai kunci dalam widget ini.

TextParagraph

Paragraf teks. Teks terformat didukung. Untuk 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

string

Gambar

Gambar yang ditentukan oleh URL dan dapat memiliki tindakan onclick.

Representasi JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "aspectRatio": number
}
Kolom
imageUrl

string

URL gambar.

onClick

object (OnClick)

Tindakan onclick.

aspectRatio

number

Rasio aspek gambar ini (lebar dan tinggi). Kolom ini memungkinkan Anda mencadangkan tinggi yang tepat untuk gambar sambil menunggu gambar dimuat. Hal 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 
{

  // Union field data can be only one of the following:
  "action": {
    object (FormAction)
  },
  "openLink": {
    object (OpenLink)
  }
  // End of list of possible types for union field data.
}
Kolom

Kolom union data.

data hanya dapat berupa salah satu dari hal berikut:

action

object (FormAction)

Tindakan formulir akan dipicu oleh tindakan onclick ini jika ditentukan.

FormAction

Tindakan formulir menjelaskan perilaku saat formulir dikirimkan. Misalnya, Anda dapat memanggil Apps Script untuk menangani formulir.

Representasi JSON 
{
  "actionMethodName": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ]
}
Kolom
actionMethodName

string

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[]

object (ActionParameter)

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 penundaan dalam daftar parameter string.

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string

Nama parameter untuk skrip tindakan.

value

string

Nilai parameter.

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 (OnClick)
  },

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  }
  // End of list of possible types for union field control.
}
Kolom
topLabel

string

Teks label atas. Teks terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

content

string

Teks konten. Teks berformat didukung dan selalu diperlukan. Untuk informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

contentMultiline

boolean

Jika konten harus multibaris.

bottomLabel

string

Teks label bawah. Teks berformat didukung. Untuk informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

onClick

object (OnClick)

Tindakan onclick. Hanya label atas, label bawah, dan wilayah konten yang dapat diklik.

Kolom union icons. Setidaknya salah satu ikon, top_label dan bottom_label harus ditentukan. icons hanya dapat berupa salah satu dari yang berikut:
icon

enum (Icon)

Nilai enum yang diganti oleh Chat API dengan gambar ikon yang sesuai.

iconUrl

string

Ikon yang ditentukan oleh URL.

Kolom union control. Widget kontrol. Anda dapat menetapkan button atau switch_widget, tetapi jangan keduanya. control hanya dapat berupa salah satu dari hal berikut:
button

object (Button)

Tombol yang dapat 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 type can be only one of the following:
  "textButton": {
    object (TextButton)
  },
  "imageButton": {
    object (ImageButton)
  }
  // End of list of possible types for union field type.
}
Kolom

Kolom gabungan type.

type hanya dapat berupa salah satu dari yang berikut:

textButton

object (TextButton)

Tombol dengan teks dan tindakan onclick.

imageButton

object (ImageButton)

Tombol dengan gambar dan tindakan onclick.

TextButton

Tombol dengan teks dan tindakan onclick.

Representasi JSON 
{
  "text": string,
  "onClick": {
    object (OnClick)
  }
}
Kolom
text

string

Teks tombol.

onClick

object (OnClick)

Tindakan onclick tombol.

ImageButton

Tombol gambar dengan tindakan onclick.

Representasi JSON 
{
  "onClick": {
    object (OnClick)
  },
  "name": string,

  // Union field icons can be only one of the following:
  "icon": enum (Icon),
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Kolom
onClick

object (OnClick)

Tindakan onclick.

name

string

Nama imageButton ini yang digunakan untuk aksesibilitas. Nilai default diberikan jika nama ini tidak ditentukan.

Kolom gabungan icons. Ikon dapat ditentukan oleh Icon enum atau URL. icons hanya dapat berupa salah satu dari hal berikut:
icon

enum (Icon)

Ikon yang ditetapkan oleh enum yang menunjukkan ikon yang disediakan oleh Chat API.

iconUrl

string

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 (OnClick)
  }
}
Kolom
actionLabel

string

Label yang biasa ditampilkan di item menu tindakan.

onClick

object (OnClick)

Tindakan onclick untuk item tindakan ini.