Card

Antarmuka kartu yang ditampilkan di pesan Google Chat atau add-on Google Workspace.

Kartu mendukung tata letak yang ditentukan, elemen UI interaktif seperti tombol, dan multimedia seperti gambar. Gunakan kartu untuk menyajikan informasi mendetail, mengumpulkan informasi dari pengguna, dan memandu pengguna untuk mengambil langkah berikutnya.

Mendesain dan melihat pratinjau kartu dengan Card Builder.

Membuka Card Builder

Untuk mempelajari cara membuat kartu, lihat dokumentasi berikut:

Catatan: Anda dapat menambahkan hingga 100 widget per kartu. Jika widget suatu bagian membuat jumlah total melebihi 100, seluruh bagian tersebut dan semua bagian berikutnya akan diabaikan. Batas ini berlaku untuk pesan kartu dan dialog di aplikasi Google Chat, serta untuk kartu di add-on Google Workspace.

Contoh: Pesan kartu untuk aplikasi Google Chat

Contoh kartu kontak

Untuk membuat contoh pesan kartu di Google Chat, gunakan JSON berikut:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
Representasi JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  },
  "expressionData": [
    {
      object (ExpressionData)
    }
  ]
}
Kolom
header

object (CardHeader)

Header kartu. Header biasanya berisi gambar utama dan judul. Header selalu muncul di bagian atas kartu.
sections[]

object (Section)

Berisi kumpulan widget. Setiap bagian memiliki header opsionalnya sendiri. Bagian dipisahkan secara visual oleh pembatas garis. Untuk contoh di aplikasi Google Chat, lihat Menentukan bagian kartu.
sectionDividerStyle

enum (DividerStyle)

Gaya pemisah antara header, bagian, dan footer.
cardActions[]

object (CardAction)

Tindakan kartu. Tindakan ditambahkan ke menu toolbar kartu. Mendukung hingga 10 item CardAction.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.

Misalnya, JSON berikut membuat menu tindakan kartu dengan opsi Settings dan Send Feedback:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

Nama kartu. Digunakan sebagai ID kartu dalam navigasi kartu.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.
displayStyle

enum (DisplayStyle)

Di add-on Google Workspace, menetapkan properti tampilan peekCardHeader.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.
peekCardHeader

object (CardHeader)

Saat menampilkan konten kontekstual, header kartu intip berfungsi sebagai placeholder sehingga pengguna dapat beralih antara kartu halaman beranda dan kartu kontekstual.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.
expressionData[]

object (ExpressionData)

Data ekspresi untuk kartu.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

CardHeader

Merepresentasikan header kartu. Untuk contoh di aplikasi Google Chat, lihat Menambahkan header.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
Kolom
title

string

Wajib. Judul header kartu. 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

string

Subjudul header kartu. Jika ditentukan, akan muncul di barisnya sendiri di bawah title.
imageType

enum (ImageType)

Bentuk yang digunakan untuk memangkas gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
imageUrl

string

URL HTTPS gambar di header kartu.
imageAltText

string

Teks alternatif gambar ini yang digunakan untuk aksesibilitas.

Bagian

Bagian berisi kumpulan widget yang dirender secara vertikal sesuai urutan yang ditentukan.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "id": string,
  "collapseControl": {
    object (CollapseControl)
  }
}
Kolom
header

string

Teks yang muncul di bagian atas bagian. Mendukung teks berformat HTML sederhana. 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 (Widget)

Semua widget di bagian tersebut. Harus berisi minimal satu widget. Kartu mendukung hingga 100 widget di semua bagian.
collapsible

boolean

Menunjukkan apakah bagian ini dapat diciutkan.

Bagian yang dapat diciutkan menyembunyikan beberapa atau semua widget, tetapi pengguna dapat meluaskan bagian tersebut untuk menampilkan widget yang tersembunyi dengan mengklik Tampilkan lebih banyak. Pengguna dapat menyembunyikan widget lagi dengan mengklik Tampilkan lebih sedikit.

Untuk menentukan widget mana yang disembunyikan, tentukan uncollapsibleWidgetsCount.
uncollapsibleWidgetsCount

integer

Jumlah widget yang tidak dapat diciutkan yang tetap terlihat meskipun bagian diciutkan.

Misalnya, jika sebuah bagian berisi lima widget dan uncollapsibleWidgetsCount ditetapkan ke 2, dua widget pertama akan selalu ditampilkan dan tiga widget terakhir akan diciutkan secara default. uncollapsibleWidgetsCount hanya dipertimbangkan jika collapsible adalah true.
id

string

ID unik yang ditetapkan ke bagian yang digunakan untuk mengidentifikasi bagian yang akan diubah. ID memiliki batas karakter 64 karakter dan harus dalam format [a-zA-Z0-9-]+.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
collapseControl

object (CollapseControl)

Opsional. Tentukan tombol luaskan dan ciutkan bagian. Tombol ini hanya akan ditampilkan jika bagian dapat diciutkan. Jika kolom ini tidak ditetapkan, tombol default akan digunakan.

Widget

Setiap kartu terdiri dari widget.

Widget adalah objek gabungan yang dapat mewakili salah satu jenis objek teks, gambar, tombol, dan lainnya.

Representasi JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "id": string,
  "visibility": enum (Visibility),
  "eventActions": [
    {
      object (EventAction)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
}
Kolom
horizontalAlignment

enum (HorizontalAlignment)

Menentukan apakah widget diratakan ke kiri, kanan, atau tengah kolom.
id

string

ID unik yang ditetapkan ke widget yang digunakan untuk mengidentifikasi widget yang akan diubah. ID memiliki batas karakter 64 karakter dan harus dalam format [a-zA-Z0-9-]+.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
visibility

enum (Visibility)

Menentukan apakah widget terlihat atau tersembunyi. Nilai default-nya adalah VISIBLE.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
eventActions[]

object (EventAction)

Menentukan tindakan peristiwa yang dapat dilakukan pada widget.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
Widget hanya dapat memiliki salah satu item berikut. Anda dapat menggunakan beberapa kolom widget untuk menampilkan lebih banyak item. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
textParagraph

object (TextParagraph)

Menampilkan paragraf teks. Mendukung teks berformat HTML sederhana. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di add-on Google Workspace.

Misalnya, JSON berikut membuat teks tebal:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

object (Image)

Menampilkan gambar.

Misalnya, JSON berikut membuat gambar dengan teks alternatif:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

object (DecoratedText)

Menampilkan item teks yang didekorasi.

Misalnya, JSON berikut membuat widget teks yang didekorasi yang menampilkan alamat email:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

object (ButtonList)

Daftar tombol.

Misalnya, JSON berikut membuat dua tombol. Yang pertama adalah tombol teks biru dan yang kedua adalah tombol gambar yang membuka link:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

object (TextInput)

Menampilkan kotak teks yang dapat diketik oleh pengguna.

Misalnya, JSON berikut membuat input teks untuk alamat email:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Sebagai contoh lain, JSON berikut membuat input teks untuk bahasa pemrograman dengan saran statis:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

object (SelectionInput)

Menampilkan kontrol pilihan yang memungkinkan pengguna memilih item. Kontrol pilihan dapat berupa kotak centang, tombol pilihan, tombol akses, atau menu dropdown.

Misalnya, JSON berikut membuat menu dropdown yang memungkinkan pengguna memilih ukuran:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

object (DateTimePicker)

Menampilkan widget yang memungkinkan pengguna memasukkan tanggal, waktu, atau tanggal dan waktu.

Misalnya, JSON berikut membuat pemilih tanggal dan waktu untuk menjadwalkan janji temu:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}
divider

object (Divider)

Menampilkan pembagi garis horizontal di antara widget.

Misalnya, JSON berikut membuat pembagi:

"divider": {
}
grid

object (Grid)

Menampilkan petak dengan kumpulan item.

Petak mendukung berapa pun jumlah kolom dan item. Jumlah baris ditentukan oleh batas atas jumlah item dibagi dengan jumlah kolom. Petak dengan 10 item dan 2 kolom memiliki 5 baris. Petak dengan 11 item dan 2 kolom memiliki 6 baris.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Misalnya, JSON berikut membuat petak 2 kolom dengan satu item:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
columns

object (Columns)

Menampilkan hingga 2 kolom.

Untuk menyertakan lebih dari 2 kolom, atau untuk menggunakan baris, gunakan widget Grid.

Misalnya, JSON berikut membuat 2 kolom yang masing-masing berisi paragraf teks:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

object (Carousel)

Berisi kumpulan item CarouselCard, yang masing-masing berisi widget bertingkat. Misalnya, ini adalah representasi JSON dari carousel yang berisi dua kartu carousel, masing-masing dengan paragraf teks:

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in the carousel."
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in the carousel."
          }
        }
      ]
    }
  ]
}
chipList

object (ChipList)

Daftar chip.

Misalnya, JSON berikut membuat dua chip. Yang pertama adalah chip teks dan yang kedua adalah chip ikon yang membuka link:

"chipList": {
  "chips": [
    {
      "label": "Edit",
      "disabled": true
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
Akhir kolom yang saling eksklusif.

TextParagraph

Paragraf teks yang mendukung pemformatan. Untuk contoh di aplikasi Google Chat, lihat Menambahkan paragraf teks berformat. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di add-on Google Workspace.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
Kolom
text

string

Teks yang ditampilkan di widget.
maxLines

integer

Jumlah maksimum baris teks yang ditampilkan di widget. Jika teks melebihi jumlah baris maksimum yang ditentukan, konten yang berlebih akan disembunyikan di balik tombol tampilkan lebih banyak. Jika teks sama dengan atau lebih pendek dari jumlah baris maksimum yang ditentukan, tombol tampilkan lebih banyak tidak akan ditampilkan.

Nilai defaultnya adalah 0, yang berarti semua konteks akan ditampilkan. Nilai negatif akan diabaikan.
textSyntax

enum (TextSyntax)

Sintaksis teks. Jika tidak ditetapkan, teks akan dirender sebagai HTML.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

TextSyntax

Sintaksis yang akan digunakan untuk memformat teks.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Enum
TEXT_SYNTAX_UNSPECIFIED Teks dirender sebagai HTML jika tidak ditentukan.
HTML Teks dirender sebagai HTML. Nilai ini merupakan default.
MARKDOWN Teks dirender sebagai Markdown.

Gambar

Gambar yang ditentukan oleh URL dan dapat memiliki tindakan onClick. Sebagai contoh, lihat Menambahkan gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

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

string

URL HTTPS yang menghosting gambar.

Contoh:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

object (OnClick)

Saat pengguna mengklik gambar, klik tersebut akan memicu tindakan ini.
altText

string

Teks alternatif gambar ini yang digunakan untuk aksesibilitas.

DecoratedText

Widget yang menampilkan teks dengan dekorasi opsional seperti label di atas atau di bawah teks, ikon di depan teks, widget pilihan, atau tombol setelah teks. Untuk contoh di aplikasi Google Chat, lihat Menampilkan teks dengan teks dekoratif.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "onClick": {
    object (OnClick)
  },

  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
}
Kolom
icon
(deprecated)

object (Icon)

Tidak digunakan lagi dan digantikan dengan startIcon.
startIcon

object (Icon)

Ikon yang ditampilkan di depan teks.
startIconVerticalAlignment

enum (VerticalAlignment)

Opsional. Perataan vertikal ikon awal. Jika tidak ditetapkan, ikon akan diposisikan di tengah secara vertikal.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.
topLabel

string

Teks yang muncul di atas text. Selalu memotong.
topLabelText

object (TextParagraph)

TextParagraph setara dengan topLabel. Selalu memotong. Memungkinkan pemformatan yang lebih kompleks daripada topLabel.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.
text

string

Wajib. Teks utama.

Mendukung pemformatan sederhana. Untuk mengetahui informasi selengkapnya tentang cara memformat teks, lihat Memformat teks di aplikasi Google Chat dan Memformat teks di add-on Google Workspace.
contentText

object (TextParagraph)

TextParagraph setara dengan text. Memungkinkan pemformatan yang lebih kompleks daripada text.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.
wrapText

boolean

Setelan penggabungan teks. Jika true, teks akan digabungkan dan ditampilkan dalam beberapa baris. Jika tidak, teks akan dipotong.

Hanya berlaku untuk text, bukan topLabel dan bottomLabel.
bottomLabel

string

Teks yang muncul di bawah text. Selalu digabungkan.
bottomLabelText

object (TextParagraph)

TextParagraph setara dengan bottomLabel. Selalu digabungkan. Memungkinkan pemformatan yang lebih kompleks daripada bottomLabel.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.
onClick

object (OnClick)

Tindakan ini dipicu saat pengguna mengklik di mana saja pada widget DecoratedText (termasuk text, topLabel, bottomLabel, dan ikon), kecuali saat mengklik kontrol interaktif terpisah (button atau switchControl).
Tombol, tombol akses, kotak centang, atau gambar yang muncul di sisi kanan teks di widget decoratedText. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
button

object (Button)

Tombol yang dapat diklik pengguna untuk memicu tindakan.
switchControl

object (SwitchControl)

Widget tombol yang dapat diklik pengguna untuk mengubah statusnya dan memicu tindakan.
endIcon

object (Icon)

Ikon yang ditampilkan setelah teks.

Mendukung ikon bawaan dan kustom.
Akhir kolom yang saling eksklusif.

VerticalAlignment

Mewakili atribut perataan vertikal.

Enum
VERTICAL_ALIGNMENT_UNSPECIFIED Jenis tidak ditentukan. Jangan gunakan.
TOP Perataan ke posisi atas.
MIDDLE Perataan ke posisi tengah.
BOTTOM Perataan ke posisi bawah.

SwitchControl

Tombol beralih atau kotak centang di dalam widget decoratedText.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Hanya didukung di widget decoratedText.

Representasi JSON 
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
Kolom
name

string

Nama yang digunakan untuk mengidentifikasi widget tombol dalam peristiwa input formulir (sebagai kunci di CommonEventObject.form_inputs).

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
value

string

Nilai yang ditampilkan di CommonEventObject.form_inputs[name].string_inputs saat tombol dipilih (selected adalah true). Jika selected adalah true dan value tidak ditetapkan, string kosong ("") akan ditampilkan di stringInputs.value. Jika selected adalah false, nilai ini akan dihilangkan dari stringInputs.value.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
selected

boolean

Jika true, tombol dipilih, dan value-nya disertakan dalam CommonEventObject.form_inputs[name].string_inputs.value.
onChangeAction

object (Action)

Tindakan yang akan dilakukan saat status tombol diubah, seperti fungsi yang akan dijalankan.
controlType

enum (ControlType)

Tampilan tombol di antarmuka pengguna.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

ControlType

Tampilan tombol di antarmuka pengguna.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
SWITCH Tombol bergaya tombol beralih.
CHECKBOX Tidak digunakan lagi dan digantikan dengan CHECK_BOX.
CHECK_BOX Kotak centang.

TextInput

Kolom tempat pengguna dapat memasukkan teks. Mendukung saran dan tindakan saat terjadi perubahan. Mendukung validasi pengiriman formulir. Jika Action.all_widgets_are_required ditetapkan ke true atau widget ini ditentukan di Action.required_widgets, tindakan pengiriman akan diblokir kecuali jika nilai dimasukkan. Untuk contoh di aplikasi Google Chat, lihat Menambahkan kolom tempat pengguna dapat memasukkan teks.

Aplikasi Chat menerima dan dapat memproses nilai teks yang dimasukkan selama peristiwa input formulir. Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.

Jika Anda perlu mengumpulkan data yang tidak ditentukan atau abstrak dari pengguna, gunakan input teks. Untuk mengumpulkan data yang ditentukan atau dihitung dari pengguna, gunakan widget SelectionInput.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string,

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Kolom
name

string

Nama yang digunakan untuk mengidentifikasi input teks dalam peristiwa input formulir.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
label

string

Teks yang muncul di atas kolom input teks di antarmuka pengguna.

Tentukan teks yang membantu pengguna memasukkan informasi yang diperlukan aplikasi Anda. Misalnya, jika Anda menanyakan nama seseorang, tetapi secara khusus memerlukan nama belakangnya, tulis surname, bukan name.

Wajib jika hintText tidak ditentukan. Jika tidak, opsional.
hintText

string

Teks yang muncul di bawah kolom input teks yang dimaksudkan untuk membantu pengguna dengan meminta mereka memasukkan nilai tertentu. Teks ini selalu terlihat.

Wajib jika label tidak ditentukan. Jika tidak, opsional.
value

string

Nilai yang dimasukkan oleh pengguna, yang ditampilkan sebagai bagian dari peristiwa input formulir.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
type

enum (Type)

Tampilan kolom input teks di antarmuka pengguna. Misalnya, apakah kolom tersebut berupa satu atau beberapa baris.
onChangeAction

object (Action)

Yang harus dilakukan saat terjadi perubahan di kolom input teks. Misalnya, pengguna menambahkan teks ke kolom atau menghapus teks.

Contoh tindakan yang dapat dilakukan mencakup menjalankan fungsi kustom atau membuka dialog di Google Chat.
initialSuggestions

object (Suggestions)

Nilai yang disarankan yang dapat dimasukkan pengguna. Nilai ini muncul saat pengguna mengklik di dalam kolom input teks. Saat pengguna mengetik, nilai yang disarankan akan difilter secara dinamis agar sesuai dengan yang diketik pengguna.

Misalnya, kolom input teks untuk bahasa pemrograman mungkin menyarankan Java, JavaScript, Python, dan C++. Saat pengguna mulai mengetik Jav, daftar saran akan difilter untuk hanya menampilkan Java dan JavaScript.

Nilai yang disarankan membantu memandu pengguna untuk memasukkan nilai yang dapat dipahami oleh aplikasi Anda. Saat merujuk ke JavaScript, beberapa pengguna mungkin memasukkan javascript dan yang lainnya java script. Menyarankan JavaScript dapat menstandarkan cara pengguna berinteraksi dengan aplikasi Anda.

Jika ditentukan, TextInput.type selalu SINGLE_LINE, meskipun ditetapkan ke MULTIPLE_LINE.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
autoCompleteAction

object (Action)

Opsional. Tentukan tindakan yang harus diambil saat kolom input teks memberikan saran kepada pengguna yang berinteraksi dengannya.

Jika tidak ditentukan, saran akan ditetapkan oleh initialSuggestions dan diproses oleh klien.

Jika ditentukan, aplikasi akan melakukan tindakan yang ditentukan di sini, seperti menjalankan fungsi kustom.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.
validation

object (Validation)

Tentukan validasi format input yang diperlukan untuk kolom teks ini.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
placeholderText

string

Teks yang muncul di kolom input teks saat kolom kosong. Gunakan teks ini untuk meminta pengguna memasukkan nilai. Misalnya, Enter a number from 0 to 100.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.
Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
hostAppDataSource

object (HostAppDataSourceMarkup)

Sumber data yang unik untuk aplikasi host Google Workspace, seperti email Gmail, acara Google Kalender, atau pesan Google Chat.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
Akhir kolom yang saling eksklusif.

Jenis

Tampilan kolom input teks di antarmuka pengguna. Misalnya, apakah kolom inputnya satu baris atau multibaris. Jika initialSuggestions ditentukan, type akan selalu berupa SINGLE_LINE, meskipun ditetapkan ke MULTIPLE_LINE.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
SINGLE_LINE Kolom input teks memiliki tinggi tetap satu baris.
MULTIPLE_LINE Kolom input teks memiliki tinggi tetap yang terdiri dari beberapa baris.

RenderActions

Serangkaian petunjuk render yang memberi tahu kartu untuk melakukan tindakan, atau memberi tahu aplikasi host add-on atau aplikasi Chat untuk melakukan tindakan khusus aplikasi.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Kolom
action

Action

Tindakan

Kolom
navigations[]

Navigation

Mendorong, memunculkan, atau memperbarui kartu.

Add-on di Google Chat.

Menambahkan kartu baru ke stack (menavigasi ke depan). Untuk aplikasi Chat, hanya tersedia untuk beranda aplikasi.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

navigations: {
  pushCard: CARD
}

Ganti kartu teratas dengan kartu baru. Untuk aplikasi Chat, hanya tersedia untuk beranda aplikasi.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

navigations: {
  updateCard: CARD
}

Saran

Nilai yang disarankan yang dapat dimasukkan pengguna. Nilai ini muncul saat pengguna mengklik di dalam kolom input teks. Saat pengguna mengetik, nilai yang disarankan akan difilter secara dinamis agar sesuai dengan yang diketik pengguna.

Misalnya, kolom input teks untuk bahasa pemrograman mungkin menyarankan Java, JavaScript, Python, dan C++. Saat pengguna mulai mengetik Jav, daftar saran akan difilter untuk menampilkan Java dan JavaScript.

Nilai yang disarankan membantu memandu pengguna untuk memasukkan nilai yang dapat dipahami oleh aplikasi Anda. Saat merujuk ke JavaScript, beberapa pengguna mungkin memasukkan javascript dan yang lainnya java script. Menyarankan JavaScript dapat menstandarkan cara pengguna berinteraksi dengan aplikasi Anda.

Jika ditentukan, TextInput.type selalu SINGLE_LINE, meskipun ditetapkan ke MULTIPLE_LINE.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
Kolom
items[]

object (SuggestionItem)

Daftar saran yang digunakan untuk rekomendasi pelengkapan otomatis di kolom input teks.

SuggestionItem

Satu nilai yang disarankan yang dapat dimasukkan pengguna di kolom input teks.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{

  "text": string
}
Kolom
Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
text

string

Nilai input yang disarankan ke kolom input teks. Hal ini setara dengan yang dimasukkan pengguna sendiri.
Akhir kolom yang saling eksklusif.

Validasi

Menampilkan data yang diperlukan untuk memvalidasi widget yang dilampirkan.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
Kolom
characterLimit

integer

Tentukan batas karakter untuk widget input teks. Perhatikan bahwa widget ini hanya digunakan untuk input teks dan diabaikan untuk widget lainnya.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
inputType

enum (InputType)

Tentukan jenis widget input.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

InputType

Jenis widget input.

Enum
INPUT_TYPE_UNSPECIFIED Jenis tidak ditentukan. Jangan gunakan.
TEXT Teks biasa yang menerima semua karakter.
INTEGER Nilai bilangan bulat.
FLOAT Nilai float.
EMAIL Alamat email.
EMOJI_PICKER Emoji yang dipilih dari pemilih emoji yang disediakan sistem.

HostAppDataSourceMarkup

Sumber data dari aplikasi Google Workspace. Sumber data mengisi item yang tersedia untuk widget.

Representasi JSON 
{

  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  },
  "workflowDataSource": {
    object (WorkflowDataSourceMarkup)
  }
}
Kolom
Aplikasi Google Workspace yang mengisi item yang tersedia untuk widget. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
chatDataSource

object (ChatClientDataSourceMarkup)

Sumber data dari Google Chat.
workflowDataSource

object (WorkflowDataSourceMarkup)

Sumber data dari Google Workflow.
Akhir kolom yang saling eksklusif.

ChatClientDataSourceMarkup

Untuk widget SelectionInput yang menggunakan menu pilihan ganda, sumber data dari Google Chat. Sumber data mengisi item pilihan untuk menu pilihan ganda. Misalnya, pengguna dapat memilih ruang Google Chat tempat mereka menjadi anggota.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Representasi JSON 
{

  "spaceDataSource": {
    object (SpaceDataSource)
  }
}
Kolom
Sumber data Google Chat. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
spaceDataSource

object (SpaceDataSource)

Ruang Google Chat tempat pengguna menjadi anggota.
Akhir kolom yang saling eksklusif.

SpaceDataSource

Sumber data yang mengisi ruang Google Chat sebagai item pilihan untuk menu multipilih. Hanya mengisi ruang tempat pengguna menjadi anggota.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Representasi JSON 
{
  "defaultToCurrentSpace": boolean
}
Kolom
defaultToCurrentSpace

boolean

Jika disetel ke true, menu pilihan ganda akan memilih ruang Google Chat saat ini sebagai item secara default.

WorkflowDataSourceMarkup

* Hanya didukung oleh Alur Kerja Google Workspace, tetapi tidak didukung oleh aplikasi Google Chat atau add-on Google Workspace.

Dalam widget TextInput atau SelectionInput dengan jenis MULTI_SELECT atau DateTimePicker, berikan sumber data dari Google.

Representasi JSON 
{
  "includeVariables": boolean,
  "type": enum (Type)
}
Kolom
includeVariables

boolean

Apakah akan menyertakan variabel dari langkah sebelumnya di sumber data.
type

enum (Type)

Jenis sumber data.

Jenis

Enum yang mewakili jenis sumber data alur kerja.

Enum
UNKNOWN Nilai default. Jangan gunakan.
USER Pengguna Google Workspace. Pengguna hanya dapat melihat dan memilih pengguna dari organisasi Google Workspace-nya.
SPACE Ruang Google Chat tempat pengguna menjadi anggota.
USER_WITH_FREE_FORM Pengguna dapat memilih untuk melihat dan memilih anggota yang ada dari organisasi Google Workspace mereka atau memasukkan alamat email atau domain yang valid secara manual.

SelectionInput

Widget yang membuat satu atau beberapa item UI yang dapat dipilih pengguna. Mendukung validasi pengiriman formulir hanya untuk menu dropdown dan multiselect. Jika Action.all_widgets_are_required ditetapkan ke true atau widget ini ditentukan di Action.required_widgets, tindakan pengiriman akan diblokir kecuali jika nilai dipilih. Misalnya, menu dropdown atau kotak centang. Anda dapat menggunakan widget ini untuk mengumpulkan data yang dapat diprediksi atau dihitung. Untuk contoh di aplikasi Google Chat, lihat Menambahkan elemen UI yang dapat dipilih.

Aplikasi Chat dapat memproses nilai item yang dipilih atau dimasukkan pengguna. Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.

Untuk mengumpulkan data yang tidak ditentukan atau abstrak dari pengguna, gunakan widget TextInput.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMinQueryLength": integer,
  "dataSourceConfigs": [
    {
      object (DataSourceConfig)
    }
  ],
  "multiSelectMaxSelectedItems": integer,
  "hintText": string,

  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
}
Kolom
name

string

Wajib. Nama yang mengidentifikasi input pilihan dalam peristiwa input formulir.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
label

string

Teks yang muncul di atas kolom input pilihan di antarmuka pengguna.

Tentukan teks yang membantu pengguna memasukkan informasi yang diperlukan aplikasi Anda. Misalnya, jika pengguna memilih urgensi tiket pekerjaan dari menu drop-down, labelnya mungkin "Urgensi" atau "Pilih urgensi".
type

enum (SelectionType)

Jenis item yang ditampilkan kepada pengguna di widget SelectionInput. Jenis pilihan mendukung berbagai jenis interaksi. Misalnya, pengguna dapat memilih satu atau beberapa kotak centang, tetapi mereka hanya dapat memilih satu nilai dari menu dropdown.
items[]

object (SelectionItem)

Array item yang dapat dipilih. Misalnya, array tombol pilihan atau kotak centang. Mendukung hingga 100 item.
onChangeAction

object (Action)

Jika ditentukan, formulir akan dikirim saat pilihan berubah. Jika tidak ditentukan, Anda harus menentukan tombol terpisah yang mengirimkan formulir.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
multiSelectMinQueryLength

integer

Untuk menu pilihan ganda, jumlah karakter teks yang dimasukkan pengguna sebelum menu menampilkan item pilihan yang disarankan.

Jika tidak disetel, menu pilihan ganda akan menggunakan nilai default berikut:

  • Jika menu menggunakan array statis item SelectionInput, setelan defaultnya adalah 0 karakter dan langsung mengisi item dari array.
  • Jika menu menggunakan sumber data dinamis (multi_select_data_source), setelan defaultnya adalah 3 karakter sebelum mengkueri sumber data untuk menampilkan item yang disarankan.
dataSourceConfigs[]

object (DataSourceConfig)

Opsional. Konfigurasi sumber data untuk kontrol pilihan. Kolom ini memberikan kontrol yang lebih terperinci atas sumber data.

Jika ditentukan, kolom multiSelectMaxSelectedItems, kolom multiSelectMinQueryLength, kolom externalDataSource, dan kolom platformDataSource akan diabaikan.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio.

Tersedia untuk Dropdown widget di aplikasi Google Chat. Untuk widget Dropdown di aplikasi Google Chat, hanya satu DataSourceConfig yang didukung. Jika beberapa DataSourceConfig ditetapkan, hanya yang pertama yang akan digunakan.
multiSelectMaxSelectedItems

integer

Untuk menu pilihan ganda, jumlah maksimum item yang dapat dipilih pengguna. Nilai minimum adalah 1 item. Jika tidak ditentukan, setelan defaultnya adalah 3 item.
hintText

string

Opsional. Teks yang muncul di bawah kolom input pilihan yang dimaksudkan untuk membantu pengguna dengan meminta mereka memasukkan nilai tertentu. Teks ini selalu terlihat.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Untuk menu pilihan ganda, sumber data yang mengisi item pilihan secara dinamis.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
externalDataSource

object (Action)

Sumber data eksternal, seperti database relasional.
platformDataSource

object (PlatformDataSource)

Sumber data dari Google Workspace.
Akhir kolom yang saling eksklusif.

SelectionType

Format untuk item yang dapat dipilih pengguna. Opsi yang berbeda mendukung jenis interaksi yang berbeda. Misalnya, pengguna dapat mencentang beberapa kotak, tetapi hanya dapat memilih satu item dari menu dropdown.

Setiap input pilihan mendukung satu jenis pilihan. Misalnya, mencampur kotak centang dan tombol tidak didukung.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
CHECK_BOX Sekumpulan kotak centang. Pengguna dapat memilih satu atau beberapa kotak centang.
RADIO_BUTTON Kumpulan tombol pilihan. Pengguna dapat memilih satu tombol pilihan.
SWITCH Sekumpulan tombol. Pengguna dapat mengaktifkan satu atau beberapa tombol akses.
DROPDOWN

Menu dropdown. Pengguna dapat memilih satu item dari menu.

Untuk aplikasi Google Chat, Anda dapat mengisi item menggunakan sumber data dinamis dan menyarankan item secara otomatis saat pengguna mengetik di menu. Misalnya, pengguna dapat mulai mengetik nama ruang Google Chat dan widget akan otomatis menyarankan ruang tersebut. Untuk mengisi item secara dinamis untuk menu dropdown, gunakan salah satu jenis sumber data berikut:

  • Data Google Workspace: Item diisi menggunakan data dari Google Workspace, seperti pengguna Google Workspace atau ruang Google Chat.
  • Data eksternal: Item diisi dari sumber data eksternal di luar Google Workspace.

Untuk contoh cara menerapkan menu drop-down untuk aplikasi Chat, lihat Menambahkan menu drop-down dan Mengisi menu drop-down secara dinamis.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.
MULTI_SELECT

Menu dengan kotak teks. Pengguna dapat mengetik dan memilih satu atau beberapa item. Untuk add-on Google Workspace, Anda harus mengisi item menggunakan array statis objek SelectionItem.

Untuk aplikasi Google Chat, Anda juga dapat mengisi item menggunakan sumber data dinamis dan menyarankan item secara otomatis saat pengguna mengetik di menu. Misalnya, pengguna dapat mulai mengetik nama ruang Google Chat dan widget akan otomatis menyarankan ruang tersebut. Untuk mengisi item secara dinamis untuk menu pilihan ganda, gunakan salah satu jenis sumber data berikut:

  • Data Google Workspace: Item diisi menggunakan data dari Google Workspace, seperti pengguna Google Workspace atau ruang Google Chat.
  • Data eksternal: Item diisi dari sumber data eksternal di luar Google Workspace.

Untuk contoh cara menerapkan menu pilihan ganda untuk aplikasi Chat, lihat Menambahkan menu pilihan ganda.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

PlatformDataSource

Untuk widget SelectionInput yang menggunakan menu pilihan ganda, sumber data dari Google Workspace. Digunakan untuk mengisi item dalam menu pilihan ganda.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Representasi JSON 
{

  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Kolom
Sumber data. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
commonDataSource

enum (CommonDataSource)

Sumber data yang digunakan bersama oleh semua aplikasi Google Workspace, seperti pengguna di organisasi Google Workspace.
hostAppDataSource

object (HostAppDataSourceMarkup)

Sumber data yang unik untuk aplikasi host Google Workspace, seperti ruang di Google Chat.

Kolom ini mendukung Library Klien Google API, tetapi tidak tersedia di Library Klien Cloud. Untuk mempelajari lebih lanjut, lihat Menginstal library klien.
Akhir kolom yang saling eksklusif.

CommonDataSource

Sumber data yang dibagikan oleh semua aplikasi Google Workspace.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Enum
UNKNOWN Nilai default. Jangan gunakan.
USER Pengguna Google Workspace. Pengguna hanya dapat melihat dan memilih pengguna dari organisasi Google Workspace-nya.

DataSourceConfig

Objek konfigurasi yang membantu mengonfigurasi sumber data untuk widget.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace yang memperluas Google Workspace Studio.

Representasi JSON 
{

  "remoteDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  "minCharactersTrigger": integer
}
Kolom
Sumber data. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
remoteDataSource

object (Action)

Data berasal dari penyedia data jarak jauh.
platformDataSource

object (PlatformDataSource)

Data tersebut berasal dari aplikasi Google Workspace.
Akhir kolom yang saling eksklusif.
minCharactersTrigger

integer

Jumlah minimum karakter yang harus dimasukkan pengguna sebelum penyedia data ini dipicu (yaitu, sebelum mulai menampilkan hasil).

DateTimePicker

Memungkinkan pengguna memasukkan tanggal, waktu, atau tanggal dan waktu. Mendukung validasi pengiriman formulir. Jika Action.all_widgets_are_required ditetapkan ke true atau widget ini ditentukan di Action.required_widgets, tindakan pengiriman akan diblokir kecuali jika nilai dipilih. Untuk contoh di aplikasi Google Chat, lihat Mengizinkan pengguna memilih tanggal dan waktu.

Pengguna dapat memasukkan teks atau menggunakan alat pilih untuk memilih tanggal dan waktu. Jika pengguna memasukkan tanggal atau waktu yang tidak valid, pemilih akan menampilkan error yang meminta pengguna memasukkan informasi dengan benar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  },

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Kolom
name

string

Nama yang digunakan untuk mengidentifikasi DateTimePicker dalam peristiwa input formulir.

Untuk mengetahui detail tentang cara menggunakan input formulir, lihat Menerima data formulir.
label

string

Teks yang meminta pengguna memasukkan tanggal, waktu, atau tanggal dan waktu. Misalnya, jika pengguna menjadwalkan janji temu, gunakan label seperti Appointment date atau Appointment date and time.
type

enum (DateTimePickerType)

Apakah widget mendukung input tanggal, waktu, atau tanggal dan waktu.
valueMsEpoch

string (int64 format)

Nilai default yang ditampilkan di widget, dalam milidetik sejak waktu epoch Unix.

Tentukan nilai berdasarkan jenis pemilih (DateTimePickerType):

  • DATE_AND_TIME: tanggal dan waktu kalender dalam UTC. Misalnya, untuk merepresentasikan 1 Januari 2023 pukul 12.00 UTC, gunakan 1672574400000.
  • DATE_ONLY: tanggal kalender pada pukul 00.00.00 UTC. Misalnya, untuk merepresentasikan 1 Januari 2023, gunakan 1672531200000.
  • TIME_ONLY: waktu dalam UTC. Misalnya, untuk merepresentasikan 12.00, gunakan 43200000 (atau 12 * 60 * 60 * 1000).
timezoneOffsetDate

integer

Angka yang mewakili selisih zona waktu dari UTC, dalam menit. Jika ditetapkan, valueMsEpoch akan ditampilkan dalam zona waktu yang ditentukan. Jika tidak disetel, nilai akan ditetapkan secara default ke setelan zona waktu pengguna.

Catatan: Kolom ini dalam menit, sedangkan payload peristiwa interaksi pengguna biasanya memberikan selisih zona waktu dalam milidetik (bagi dengan 60000 untuk mengonversi).
onChangeAction

object (Action)

Dipicu saat pengguna mengklik Simpan atau Hapus dari antarmuka DateTimePicker.
Sumber data yang ditentukan untuk mewakili tanggal dan waktu. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
hostAppDataSource

object (HostAppDataSourceMarkup)

Sumber data yang unik untuk aplikasi host Google Workspace, seperti email Gmail, acara Google Kalender, atau pesan Google Chat.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.
Akhir kolom yang saling eksklusif.

DateTimePickerType

Format tanggal dan waktu di widget DateTimePicker. Menentukan apakah pengguna dapat memasukkan tanggal, waktu, atau tanggal dan waktu.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
DATE_AND_TIME Pengguna memasukkan tanggal dan waktu.
DATE_ONLY Pengguna memasukkan tanggal.
TIME_ONLY Pengguna memasukkan waktu.

Pembatas

Jenis ini tidak memiliki kolom.

Menampilkan pembagi di antara widget sebagai garis horizontal. Untuk contoh di aplikasi Google Chat, lihat Menambahkan pemisah horizontal di antara widget.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Misalnya, JSON berikut membuat pembagi:

"divider": {}

Petak

Menampilkan petak dengan kumpulan item. Item hanya dapat menyertakan teks atau gambar. Untuk kolom responsif, atau untuk menyertakan lebih dari sekadar teks atau gambar, gunakan Columns. Untuk contoh di aplikasi Google Chat, lihat Menampilkan Petak dengan kumpulan item.

Petak mendukung berapa pun jumlah kolom dan item. Jumlah baris ditentukan oleh item dibagi dengan kolom. Petak dengan 10 item dan 2 kolom memiliki 5 baris. Petak dengan 11 item dan 2 kolom memiliki 6 baris.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Misalnya, JSON berikut membuat petak 2 kolom dengan satu item:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}
Representasi JSON 
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
Kolom
title

string

Teks yang ditampilkan di header petak.
items[]

object (GridItem)

Item yang akan ditampilkan di petak.
borderStyle

object (BorderStyle)

Gaya batas yang akan diterapkan ke setiap item petak.
columnCount

integer

Jumlah kolom yang akan ditampilkan dalam petak. Nilai default akan digunakan jika kolom ini tidak ditentukan, dan nilai default tersebut berbeda bergantung pada tempat petak ditampilkan (dialog versus pengiring).
onClick

object (OnClick)

Callback ini digunakan kembali oleh setiap item petak, tetapi dengan ID item yang ditambahkan ke parameter callback (di bawah kunci "grid_item_identifier").

GridItem

Mewakili item dalam tata letak petak. Item dapat berisi teks, gambar, atau teks dan gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
Kolom
id

string

ID yang ditentukan pengguna untuk item petak ini. ID ini ditampilkan dalam parameter callback onClick petak induk.
image

object (ImageComponent)

Gambar yang ditampilkan di item petak.
title

string

Judul item petak.
subtitle

string

Subjudul item petak.
layout

enum (GridItemLayout)

Tata letak yang akan digunakan untuk item petak.

ImageComponent

Merepresentasikan gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
Kolom
imageUri

string

URL gambar.
altText

string

Label aksesibilitas untuk gambar.
cropStyle

object (ImageCropStyle)

Gaya pemangkasan yang akan diterapkan ke gambar.
borderStyle

object (BorderStyle)

Gaya batas yang akan diterapkan ke gambar.

ImageCropStyle

Merepresentasikan gaya pemangkasan yang diterapkan pada gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Misalnya, berikut cara menerapkan rasio aspek 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
Representasi JSON 
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
Kolom
type

enum (ImageCropType)

Jenis tanaman.
aspectRatio

number

Rasio aspek yang akan digunakan jika jenis pemangkasan adalah RECTANGLE_CUSTOM.

Misalnya, berikut cara menerapkan rasio aspek 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

Merepresentasikan gaya pemangkasan yang diterapkan pada gambar.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
IMAGE_CROP_TYPE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
SQUARE Nilai default. Menerapkan pemangkasan persegi.
CIRCLE Menerapkan pemangkasan melingkar.
RECTANGLE_CUSTOM Menerapkan pemangkasan persegi panjang dengan rasio aspek kustom. Tetapkan rasio aspek kustom dengan aspectRatio.
RECTANGLE_4_3 Menerapkan pemangkasan persegi panjang dengan rasio aspek 4:3.

BorderStyle

Opsi gaya untuk batas kartu atau widget, termasuk jenis dan warna batas.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
Kolom
type

enum (BorderType)

Jenis batas.
strokeColor

object (Color)

Warna yang akan digunakan jika jenisnya adalah BORDER_TYPE_STROKE.

Untuk menetapkan warna goresan, tentukan nilai untuk kolom red, green, dan blue. Nilainya harus berupa angka float antara 0 dan 1 berdasarkan nilai warna RGB, dengan 0 (0/255) mewakili ketiadaan warna dan 1 (255/255) mewakili intensitas maksimum warna.

Misalnya, kode berikut menetapkan warna menjadi merah pada intensitas maksimumnya:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

Kolom alpha tidak tersedia untuk warna goresan. Jika ditentukan, kolom ini akan diabaikan.
cornerRadius

integer

Radius sudut untuk batas.

BorderType

Menunjukkan jenis batas yang diterapkan ke widget.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
BORDER_TYPE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
NO_BORDER Tidak ada batas.
STROKE Nilai default. Garis luar.

GridItemLayout

Merepresentasikan berbagai opsi tata letak yang tersedia untuk item petak.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
GRID_ITEM_LAYOUT_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
TEXT_BELOW Judul dan subjudul ditampilkan di bawah gambar item petak.
TEXT_ABOVE Judul dan subjudul ditampilkan di atas gambar item petak.

Kolom

Widget Columns menampilkan hingga 2 kolom dalam kartu atau dialog. Anda dapat menambahkan widget ke setiap kolom; widget akan muncul sesuai urutan yang ditentukan. Untuk contoh di aplikasi Google Chat, lihat Menampilkan kartu dan dialog dalam kolom.

Tinggi setiap kolom ditentukan oleh kolom yang lebih tinggi. Misalnya, jika kolom pertama lebih tinggi daripada kolom kedua, kedua kolom akan memiliki tinggi kolom pertama. Karena setiap kolom dapat berisi jumlah widget yang berbeda, Anda tidak dapat menentukan baris atau menyelaraskan widget di antara kolom.

Kolom ditampilkan berdampingan. Anda dapat menyesuaikan lebar setiap kolom menggunakan kolom HorizontalSizeStyle. Jika lebar layar pengguna terlalu sempit, kolom kedua akan digabungkan di bawah kolom pertama:

  • Di web, kolom kedua akan digabungkan jika lebar layar kurang dari atau sama dengan 480 piksel.
  • Di perangkat iOS, kolom kedua akan digabungkan jika lebar layar kurang dari atau sama dengan 300 pt.
  • Di perangkat Android, kolom kedua akan digabungkan jika lebar layar kurang dari atau sama dengan 320 dp.

Untuk menyertakan lebih dari dua kolom, atau untuk menggunakan baris, gunakan widget Grid.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace. UI add-on yang mendukung kolom meliputi:

  • Dialog yang ditampilkan saat pengguna membuka add-on dari draf email.
  • Dialog yang ditampilkan saat pengguna membuka add-on dari menu Tambahkan lampiran di acara Google Kalender.
Representasi JSON 
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
Kolom
columnItems[]

object (Column)

Array kolom. Anda dapat menyertakan hingga 2 kolom dalam kartu atau dialog.

Kolom

Kolom.

Add-on Google Workspace dan aplikasi Chat

Representasi JSON 
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
Kolom
horizontalSizeStyle

enum (HorizontalSizeStyle)

Menentukan cara kolom mengisi lebar kartu.
horizontalAlignment

enum (HorizontalAlignment)

Menentukan apakah widget diratakan ke kiri, kanan, atau tengah kolom.
verticalAlignment

enum (VerticalAlignment)

Menentukan apakah widget diratakan ke atas, bawah, atau tengah kolom.
widgets[]

object (Widgets)

Array widget yang disertakan dalam kolom. Widget muncul sesuai urutan yang ditentukan.

HorizontalSizeStyle

Menentukan cara kolom mengisi lebar kartu. Lebar setiap kolom bergantung pada HorizontalSizeStyle dan lebar widget dalam kolom.

Add-on Google Workspace dan aplikasi Chat

Enum
HORIZONTAL_SIZE_STYLE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
FILL_AVAILABLE_SPACE Nilai default. Kolom mengisi ruang yang tersedia, hingga 70% dari lebar kartu. Jika kedua kolom ditetapkan ke FILL_AVAILABLE_SPACE, setiap kolom akan mengisi 50% ruang.
FILL_MINIMUM_SPACE Kolom mengisi ruang sesedikit mungkin dan tidak lebih dari 30% lebar kartu.

HorizontalAlignment

Menentukan apakah widget diratakan ke kiri, kanan, atau tengah kolom.

Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Enum
HORIZONTAL_ALIGNMENT_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
START Nilai default. Menyejajarkan widget ke posisi awal kolom. Untuk tata letak dari kiri ke kanan, sejajarkan ke kiri. Untuk tata letak kanan ke kiri, sejajarkan ke kanan.
CENTER Meratakan widget ke tengah kolom.
END Menyejajarkan widget ke posisi akhir kolom. Untuk tata letak dari kiri ke kanan, sejajarkan widget ke kanan. Untuk tata letak kanan ke kiri, sejajarkan widget ke kiri.

VerticalAlignment

Menentukan apakah widget diratakan ke atas, bawah, atau tengah kolom.

Add-on Google Workspace dan aplikasi Chat

Enum
VERTICAL_ALIGNMENT_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
CENTER Nilai default. Meratakan widget ke tengah kolom.
TOP Menyejajarkan widget ke bagian atas kolom.
BOTTOM Menyejajarkan widget ke bagian bawah kolom.

Widget

Widget yang didukung yang dapat Anda sertakan dalam kolom.

Add-on Google Workspace dan aplikasi Chat

Representasi JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
}
Kolom
Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
textParagraph

object (TextParagraph)

Widget TextParagraph.
image

object (Image)

Widget Image.
decoratedText

object (DecoratedText)

Widget DecoratedText.
buttonList

object (ButtonList)

Widget ButtonList.
textInput

object (TextInput)

Widget TextInput.
selectionInput

object (SelectionInput)

Widget SelectionInput.
dateTimePicker

object (DateTimePicker)

Widget DateTimePicker.
chipList

object (ChipList)

Widget ChipList.
Akhir kolom yang saling eksklusif.

ChipList

Daftar chip yang disusun secara horizontal, yang dapat di-scroll secara horizontal atau digabungkan ke baris berikutnya.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
Kolom
layout

enum (Layout)

Tata letak daftar chip yang ditentukan.
chips[]

object (Chip)

Array chip.

Tata Letak

Tata letak daftar chip.

Enum
LAYOUT_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
WRAPPED Nilai default. Daftar chip akan digulung ke baris berikutnya jika tidak ada cukup ruang horizontal.
HORIZONTAL_SCROLLABLE Chip di-scroll secara horizontal jika tidak muat di ruang yang tersedia.

Chip

Chip teks, ikon, atau teks dan ikon yang dapat diklik pengguna.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
Kolom
icon

object (Icon)

Gambar ikon. Jika icon dan label ditetapkan, ikon akan muncul sebelum label.
label

string

Teks yang ditampilkan di dalam chip.
onClick

object (OnClick)

Opsional. Tindakan yang akan dilakukan saat pengguna mengklik chip, seperti membuka hyperlink atau menjalankan fungsi kustom.
enabled
(deprecated)

boolean

Tidak digunakan lagi: Gunakan disabled sebagai gantinya.

Apakah chip dalam status aktif dan merespons tindakan pengguna.
disabled

boolean

Apakah chip dalam status tidak aktif dan mengabaikan tindakan pengguna. Default-nya adalah false.
altText

string

Teks alternatif yang digunakan untuk aksesibilitas.

Tetapkan teks deskriptif yang memberi tahu pengguna fungsi chip. Misalnya, jika chip membuka hyperlink, tulis: "Membuka tab browser baru dan membuka dokumentasi developer Google Chat di https://developers.google.com/workspace/chat".

CarouselCard

Kartu yang dapat ditampilkan sebagai item carousel. Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Representasi JSON 
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
Kolom
widgets[]

object (NestedWidget)

Daftar widget yang ditampilkan di kartu carousel. Widget ditampilkan sesuai urutan yang ditentukan.
footerWidgets[]

object (NestedWidget)

Daftar widget yang ditampilkan di bagian bawah kartu carousel. Widget ditampilkan sesuai urutan yang ditentukan.

NestedWidget

Daftar widget yang dapat ditampilkan dalam tata letak penampung, seperti CarouselCard. Tersedia untuk aplikasi Google Chat dan tidak tersedia untuk add-on Google Workspace.

Representasi JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
}
Kolom
Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
textParagraph

object (TextParagraph)

Widget paragraf teks.
buttonList

object (ButtonList)

Widget daftar tombol.
image

object (Image)

Widget gambar.
Akhir kolom yang saling eksklusif.

Visibilitas

Menentukan apakah elemen UI terlihat atau tersembunyi.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Enum
VISIBILITY_UNSPECIFIED Visibilitas tidak ditentukan. Jangan gunakan.
VISIBLE Elemen UI terlihat.
HIDDEN Elemen UI disembunyikan.

EventAction

Merepresentasikan tindakan yang dapat dilakukan pada elemen UI.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "actionRuleId": string,
  "postEventTriggers": [
    {
      object (Trigger)
    }
  ],

  "commonWidgetAction": {
    object (CommonWidgetAction)
  }
}
Kolom
actionRuleId

string

ID unik ActionRule.
postEventTriggers[]

object (Trigger)

Daftar pemicu yang akan dipicu setelah EventAction dijalankan.
Tindakan yang akan dilakukan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
commonWidgetAction

object (CommonWidgetAction)

Tindakan widget umum.
Akhir kolom yang saling eksklusif.

Pemicu

Merepresentasikan pemicu.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "actionRuleId": string
}
Kolom
actionRuleId

string

ID unik ActionRule.

CommonWidgetAction

Merepresentasikan tindakan yang tidak spesifik untuk widget.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{

  "updateVisibilityAction": {
    object (UpdateVisibilityAction)
  }
}
Kolom
Tindakan yang akan dilakukan. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
updateVisibilityAction

object (UpdateVisibilityAction)

Tindakan untuk memperbarui visibilitas widget.
Akhir kolom yang saling eksklusif.

UpdateVisibilityAction

Merepresentasikan tindakan yang memperbarui visibilitas widget.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "visibility": enum (Visibility)
}
Kolom
visibility

enum (Visibility)

Visibilitas baru.

CollapseControl

Merepresentasikan kontrol luaskan dan ciutkan.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
Kolom
horizontalAlignment

enum (HorizontalAlignment)

Perataan horizontal tombol luaskan dan ciutkan.
expandButton

object (Button)

Opsional. Tentukan tombol yang dapat disesuaikan untuk meluaskan bagian. Kolom expandButton dan collapseButton harus ditetapkan. Hanya satu set kolom yang tidak akan diterapkan. Jika kolom ini tidak ditetapkan, tombol default akan digunakan.
collapseButton

object (Button)

Opsional. Tentukan tombol yang dapat disesuaikan untuk menciutkan bagian. Kolom expandButton dan collapseButton harus ditetapkan. Hanya satu set kolom yang tidak akan diterapkan. Jika kolom ini tidak ditetapkan, tombol default akan digunakan.

DividerStyle

Gaya pembagi kartu. Saat ini hanya digunakan untuk pembagi di antara bagian kartu.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Enum
DIVIDER_STYLE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
SOLID_DIVIDER Opsi default. Merender pembagi solid.
NO_DIVIDER Jika ditetapkan, tidak ada pembagi yang dirender. Gaya ini sepenuhnya menghapus pemisah dari tata letak. Hasilnya sama dengan tidak menambahkan pembagi sama sekali.

CardAction

Tindakan kartu adalah tindakan yang terkait dengan kartu. Misalnya, kartu invoice dapat menyertakan tindakan seperti menghapus invoice, mengirim invoice melalui email, atau membuka invoice di browser.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.

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

string

Label yang ditampilkan sebagai item menu tindakan.
onClick

object (OnClick)

Tindakan onClick untuk item tindakan ini.

CardFixedFooter

Footer persisten (tetap) yang muncul di bagian bawah kartu.

Menetapkan fixedFooter tanpa menentukan primaryButton atau secondaryButton akan menyebabkan error.

Untuk aplikasi Chat, Anda dapat menggunakan footer tetap dalam dialog, tetapi tidak dalam pesan kartu. Untuk contoh di aplikasi Google Chat, lihat Menambahkan footer persisten.

Tersedia untuk aplikasi Google Chat dan add-on Google Workspace.

Representasi JSON 
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
Kolom
primaryButton

object (Button)

Tombol utama footer tetap. Tombol harus berupa tombol teks dengan teks dan warna yang ditetapkan.
secondaryButton

object (Button)

Tombol sekunder footer tetap. Tombol harus berupa tombol teks dengan teks dan warna yang ditetapkan. Jika secondaryButton ditetapkan, Anda juga harus menetapkan primaryButton.

DisplayStyle

Di add-on Google Workspace, menentukan cara kartu ditampilkan.

Tersedia untuk add-on Google Workspace dan tidak tersedia untuk aplikasi Google Chat.

Enum
DISPLAY_STYLE_UNSPECIFIED Jangan gunakan. Tidak ditentukan.
PEEK Header kartu muncul di bagian bawah sidebar, yang menutupi sebagian kartu teratas saat ini dalam tumpukan. Mengklik header akan memunculkan kartu ke dalam tumpukan kartu. Jika kartu tidak memiliki header, header yang dihasilkan akan digunakan.
REPLACE Nilai default. Kartu ditampilkan dengan mengganti tampilan kartu teratas di tumpukan kartu.

ExpressionData

Merepresentasikan data yang digunakan untuk mengevaluasi ekspresi.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "id": string,
  "expression": string,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "eventActions": [
    {
      object (EventAction)
    }
  ]
}
Kolom
id

string

ID unik ExpressionData.
expression

string

Ekspresi yang tidak dikompilasi.
conditions[]

object (Condition)

Daftar kondisi yang ditentukan oleh hasil evaluasi ekspresi.
eventActions[]

object (EventAction)

Daftar tindakan yang dapat digunakan ExpressionData.

Kondisi

Menampilkan kondisi yang dapat digunakan untuk memicu tindakan.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "actionRuleId": string,

  "expressionDataCondition": {
    object (ExpressionDataCondition)
  }
}
Kolom
actionRuleId

string

ID unik ActionRule.
Kondisi. Berikut adalah daftar kolom yang sama-sama bersifat eksklusif. Maksimal satu kolom akan ditetapkan dalam respons:
expressionDataCondition

object (ExpressionDataCondition)

Kondisi yang ditentukan oleh data ekspresi.
Akhir kolom yang saling eksklusif.

ExpressionDataCondition

Merepresentasikan kondisi yang dievaluasi menggunakan CEL.

Tersedia untuk add-on Google Workspace yang memperluas Google Workspace Studio. Tidak tersedia untuk aplikasi Google Chat.

Representasi JSON 
{
  "conditionType": enum (ConditionType)
}
Kolom
conditionType

enum (ConditionType)

Jenis kondisi.

ConditionType

Jenis kondisi.

Enum
CONDITION_TYPE_UNSPECIFIED Jenis kondisi yang tidak ditentukan.
EXPRESSION_EVALUATION_SUCCESS Evaluasi ekspresi berhasil.
EXPRESSION_EVALUATION_FAILURE Evaluasi ekspresi tidak berhasil.