Infokarte
Eine Karte ist ein UI-Element, das UI-Widgets wie Text und Bilder enthalten kann.
JSON-Darstellung |
---|
{ "header": { object ( |
Felder | |
---|---|
header
|
Die Kopfzeile der Karte. Eine Kopfzeile enthält normalerweise einen Titel und ein Bild. |
sections[]
|
Die einzelnen Abschnitte sind durch eine Trennlinie voneinander getrennt. |
card
|
Die Aktionen dieser Karte. |
name
|
Name der Karte. |
CardHeader
JSON-Darstellung |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum ( |
Felder | |
---|---|
title
|
Der Titel muss angegeben werden. Die Kopfzeile hat eine feste Höhe: Wenn sowohl ein Titel als auch eine Unterüberschrift angegeben sind, belegt jede eine Zeile. Wenn nur der Titel angegeben ist, werden beide Zeilen ausgefüllt. |
subtitle
|
Der Untertitel der Kartenüberschrift. |
image
|
Der Typ des Bildes (z. B. quadratischer oder kreisförmiger Rahmen). |
image
|
Die URL des Bildes in der Kartenüberschrift. |
ImageStyle
Enums | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Quadratische Rahmenlinie. |
AVATAR
|
Kreisförmiger Rahmen. |
Abschnitt
Ein Abschnitt enthält eine Sammlung von Widgets, die (vertikal) in der angegebenen Reihenfolge gerendert werden. Karten haben auf allen Plattformen eine schmale feste Breite. Daher sind derzeit keine Layout-Properties (z. B. „float“) erforderlich.
JSON-Darstellung |
---|
{
"header": string,
"widgets": [
{
object ( |
Felder | |
---|---|
header
|
Die Überschrift des Abschnitts. Formatierter Text wird unterstützt. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren. |
widgets[]
|
Ein Abschnitt muss mindestens ein Widget enthalten. |
WidgetMarkup
Ein Widget ist ein UI-Element, das Text und Bilder enthält.
JSON-Darstellung |
---|
{ "buttons": [ { object ( |
Felder | |
---|---|
buttons[]
|
Eine Liste mit Schaltflächen. Buttons ist auch |
Union-Feld data . Ein WidgetMarkup kann nur eines der folgenden Elemente enthalten. Sie können mehrere WidgetMarkup -Felder verwenden, um mehr Elemente anzuzeigen.
Für data ist nur einer der folgenden Werte zulässig:
|
|
text
|
Textabschnitt in diesem Widget anzeigen. |
image
|
Bild in diesem Widget anzeigen. |
key
|
Zeigt ein Schlüsselwertelement in diesem Widget an. |
TextParagraph
Einen Textabschnitt. Formatierter Text wird unterstützt. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren.
JSON-Darstellung |
---|
{ "text": string } |
Felder | |
---|---|
text
|
|
Bild
Ein Bild, das durch eine URL angegeben wird und eine onclick
-Aktion haben kann.
JSON-Darstellung |
---|
{
"imageUrl": string,
"onClick": {
object ( |
Felder | |
---|---|
image
|
Die URL des Bildes. |
on
|
Die Aktion |
aspect
|
Das Seitenverhältnis dieses Bildes (Breite und Höhe). Mit diesem Feld können Sie die richtige Höhe für das Bild reservieren, während es geladen wird. Es ist nicht dazu gedacht, das integrierte Seitenverhältnis des Bildes zu überschreiben. Wenn das Attribut nicht festgelegt ist, wird es vom Server durch Vorabladen des Bildes ausgefüllt. |
OnClick
Eine onclick
-Aktion (z. B. Öffnen eines Links)
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
Für |
|
action
|
Durch diese |
open
|
Mit dieser |
FormAction
Mit einer Formularaktion wird das Verhalten beim Senden des Formulars beschrieben. Sie können beispielsweise Apps Script aufrufen, um das Formular zu verarbeiten.
JSON-Darstellung |
---|
{
"actionMethodName": string,
"parameters": [
{
object ( |
Felder | |
---|---|
action
|
Anhand des Methodennamens wird ermittelt, welcher Teil des Formulars die Formulareinreichung ausgelöst hat. Diese Informationen werden im Rahmen des Kartenklickereignisses an die Chat-App zurückgegeben. Sie können denselben Methodennamen für mehrere Elemente verwenden, die ein gemeinsames Verhalten auslösen. |
parameters[]
|
Liste der Aktionsparameter. |
ActionParameter
Liste der Stringparameter, die beim Aufruf der Aktionsmethode angegeben werden müssen. Angenommen, Sie haben drei Schlummertasten: „Jetzt“, „Einen Tag“ und „Nächste Woche“. Sie können action method = snooze()
verwenden und den Schlummertyp und die Schlummerzeit in der Liste der Stringparameter übergeben.
JSON-Darstellung |
---|
{ "key": string, "value": string } |
Felder | |
---|---|
key
|
Der Name des Parameters für das Aktionsscript. |
value
|
Wert des Parameters. |
OpenLink
Ein Link, der ein neues Fenster öffnet.
JSON-Darstellung |
---|
{ "url": string } |
Felder | |
---|---|
url
|
Die URL, die geöffnet werden soll. |
KeyValue
Ein UI-Element enthält einen Schlüssel (Label) und einen Wert (Inhalt). Dieses Element kann auch einige Aktionen enthalten, z. B. die Schaltfläche onclick
.
JSON-Darstellung |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Felder | |
---|---|
top
|
Der Text des oberen Labels. Formatierter Text wird unterstützt. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren. |
content
|
Der Text des Inhalts. Formatierter Text wird unterstützt und ist immer erforderlich. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren. |
content
|
Ob der Inhalt mehrzeilig sein soll |
bottom
|
Der Text des unteren Labels. Formatierter Text wird unterstützt. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren. |
on
|
Die Aktion |
Union-Feld
icons . Mindestens eines der Symbole, top_label und bottom_label , muss definiert werden.
Für icons ist nur einer der folgenden Werte zulässig:
|
|
icon
|
Ein Enum-Wert, der von der Chat API durch das entsprechende Symbolbild ersetzt wird. |
icon
|
Das Symbol, das durch eine URL angegeben wird. |
Union-Feld
control . Ein Kontroll-Widget. Sie können entweder button oder switch_widget festlegen, aber nicht beides.
control darf nur einen der folgenden Werte haben:
|
|
button
|
Eine Schaltfläche, über die eine Aktion ausgelöst werden kann. |
Symbol
Die Gruppe der unterstützten Symbole.
Enums | |
---|---|
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
|
Schaltfläche
Eine Schaltfläche. Kann eine Text- oder Bildschaltfläche sein.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
Für |
|
text
|
Eine Schaltfläche mit Text und einer |
image
|
Eine Schaltfläche mit Bild und |
TextButton
Eine Schaltfläche mit Text und der Aktion onclick
.
JSON-Darstellung |
---|
{
"text": string,
"onClick": {
object ( |
Felder | |
---|---|
text
|
Text der Schaltfläche |
on
|
Die Aktion |
ImageButton
Eine Bildschaltfläche mit einer onclick
-Aktion.
JSON-Darstellung |
---|
{ "onClick": { object ( |
Felder | |
---|---|
on
|
Die Aktion |
name
|
Der Name dieses |
Union-Feld icons . Das Symbol kann durch einen Icon , einen enum oder eine URL angegeben werden.
Für icons ist nur einer der folgenden Werte zulässig:
|
|
icon
|
Das durch eine |
icon
|
Das durch eine URL angegebene Symbol. |
CardAction
Eine Kartenaktion ist die mit der Karte verknüpfte Aktion. Eine typische Aktion für eine Rechnungskarte wäre: eine Rechnung löschen, eine E-Mail-Rechnung senden oder die Rechnung im Browser öffnen.
Wird von Google Chat-Apps nicht unterstützt.
JSON-Darstellung |
---|
{
"actionLabel": string,
"onClick": {
object ( |
Felder | |
---|---|
action
|
Das Label wurde früher im Menüpunkt „Aktion“ angezeigt. |
on
|
Die onclick-Aktion für dieses Aktionselement. |