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. {i>Header<i} biasanya berisi judul dan gambar.

sections[]

object (Section)

Bagian-bagian dipisahkan oleh pembagi 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 ditetapkan. Header memiliki tinggi tetap: jika judul dan subjudul ditentukan, masing-masing membutuhkan satu baris. Jika hanya judul yang ditentukan, kode tersebut akan menggunakan 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 properti tata letak tidak diperlukan (misalnya, float).

Representasi JSON
{
  "header": string,
  "widgets": [
    {
      object (WidgetMarkup)
    }
  ]
}
Kolom
header

string

Header bagian. Teks terformat didukung. Untuk informasi selengkapnya tentang 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 dari isian ini yang harus ditetapkan.

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

object (TextParagraph)

Tampilkan paragraf teks dalam widget ini.

image

object (Image)

Tampilkan gambar dalam widget ini.

keyValue

object (KeyValue)

Tampilkan item nilai kunci dalam widget ini.

TextParagraph

Paragraf teks. Teks terformat didukung. Untuk informasi selengkapnya tentang 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 onclick tindakan.

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

string

URL gambar.

onClick

object (OnClick)

Tujuan onclick tindakan.

aspectRatio

number

Rasio aspek gambar ini (lebar dan tinggi). Kolom ini memungkinkan Anda mencadangkan tinggi yang tepat untuk gambar selagi menunggu gambar dimuat. Hal ini tidak dimaksudkan untuk mengganti rasio aspek bawaan gambar. Jika tidak disetel, server akan mengisinya dengan melakukan pengambilan data gambar.

OnClick

Channel 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 dipicu oleh tindakan ini onclick 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 mana 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 tidur sebentar: penundaan sekarang, tunda satu hari, tunda minggu depan. Anda mungkin menggunakan action method = snooze(), yang meneruskan jenis tunda dan waktu tunda 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 onclick tombol.

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 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 terformat didukung. Untuk informasi selengkapnya tentang memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di Add-on Google Workspace.

onClick

object (OnClick)

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

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

enum (Icon)

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

iconUrl

string

Ikon yang ditentukan oleh URL.

Kolom union control. Widget kontrol. Anda dapat menyetel button atau switch_widget, tetapi tidak 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 union type.

type hanya dapat berupa salah satu dari hal berikut:

textButton

object (TextButton)

Sebuah tombol dengan teks dan onclick tindakan.

imageButton

object (ImageButton)

Sebuah tombol dengan gambar dan onclick tindakan.

TextButton

Sebuah tombol dengan teks dan onclick tindakan.

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

string

Teks tombol.

onClick

object (OnClick)

Tujuan onclick tindakan dari tombol.

ImageButton

Tombol gambar dengan onclick tindakan.

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)

Tujuan onclick tindakan.

name

string

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

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

enum (Icon)

Ikon yang ditentukan oleh enum yang menjadi indeks 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.