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 garis pemisah.

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 memerlukan satu baris. Jika hanya judul yang ditentukan, judul akan mengisi kedua baris.

subtitle

string

Subjudul header kartu.

imageStyle

enum (ImageStyle)

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

imageUrl

string

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 (WidgetMarkup)
    }
  ]
}
Kolom
header

string

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

object (WidgetMarkup)

Bagian harus berisi setidaknya satu widget.

WidgetMarkup

Widget adalah elemen UI yang menampilkan 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 merupakan oneof data dan hanya salah satu dari kolom ini yang harus ditetapkan.

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

object (TextParagraph)

Tampilkan paragraf teks dalam widget ini.

image

object (Image)

Tampilkan gambar di widget ini.

keyValue

object (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

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 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 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 gabungan data.

data hanya dapat berupa salah satu dari yang berikut:

action

object (FormAction)

Tindakan formulir 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 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 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 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

string

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

boolean

Jika konten harus terdiri dari multi-garis.

bottomLabel

string

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

object (OnClick)

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

Kolom gabungan 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 gabungan control. Widget kontrol. Anda dapat menetapkan button atau switch_widget, tetapi tidak keduanya. control hanya dapat berupa salah satu dari yang berikut:
button

object (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 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 melalui Icon enum atau URL. icons hanya dapat berupa salah satu dari yang berikut:
icon

enum (Icon)

Ikon yang ditentukan oleh enum yang mengindeks ke 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 digunakan untuk ditampilkan di item menu tindakan.

onClick

object (OnClick)

Tindakan onclick untuk item tindakan ini.