Infokarte
Eine Karte, die in einer Google Chat-Nachricht oder einem Google Workspace-Add-on angezeigt wird
Karten unterstützen ein festgelegtes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Verwenden Sie Karten, um detaillierte Informationen zu präsentieren, Informationen von Nutzern zu erfassen und sie bei den nächsten Schritten zu unterstützen.
Mit dem Card Builder Karten entwerfen und eine Vorschau anzeigen
Card Builder öffnen
Informationen zum Erstellen von Karten finden Sie in der folgenden Dokumentation:
- Informationen zu Google Chat-Apps finden Sie unter Entwerfen Sie die Komponenten einer Karte oder eines Dialogfelds.
- Informationen zu Google Workspace-Add-ons finden Sie unter Kartenbasierte Oberflächen:
Beispiel: Kartennachricht für eine Google Chat App
Verwenden Sie die folgende JSON-Datei, um die Beispielkarte in Google Chat zu erstellen:
{
"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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
JSON-Darstellung |
---|
{ "header": { object ( |
Felder | |
---|---|
header
|
Der Header der Karte. Eine Überschrift enthält normalerweise ein führendes Bild und einen Titel. Überschriften werden immer oben auf einer Karte angezeigt. |
sections[]
|
Enthält eine Sammlung von Widgets. Jeder Abschnitt hat eine eigene, optionale Kopfzeile. Die Abschnitte sind visuell durch eine Trennlinie voneinander getrennt. Ein Beispiel in Google Chat-Apps finden Sie unter Abschnitt einer Karte definieren |
sectionDividerStyle
|
Der Trennungsstil zwischen Abschnitten. |
cardActions[]
|
Die Aktionen der Karte. Aktionen werden dem Symbolleistenmenü der Karte hinzugefügt. Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps.
Im folgenden JSON-Code wird beispielsweise ein Kartenaktionsmenü mit den Optionen
|
name
|
Name der Karte. Wird als Kartenkennung in der Kartennavigation verwendet. Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps. |
fixedFooter
|
Die feste Fußzeile, die unten auf dieser Karte angezeigt wird.
Einstellung
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
displayStyle
|
Hier legen Sie in Google Workspace Add-ons die Anzeigeeigenschaften der Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
peekCardHeader
|
Wenn kontextbezogene Inhalte angezeigt werden, dient die Überschrift der Minikarte als Platzhalter, damit Nutzer zwischen den Startseitenkarten und den kontextbezogenen Karten vor- und zurückwechseln können. Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
CardHeader
Stellt eine Kartenüberschrift dar. Ein Beispiel in Google Chat-Apps finden Sie unter Header hinzufügen
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"title": string,
"subtitle": string,
"imageType": enum (
|
Felder | |
---|---|
title
|
Erforderlich. Der Titel der Kartenüberschrift. 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. Erscheint gegebenenfalls in einer eigenen Zeile unterhalb der
|
imageType
|
Die Form, die zum Zuschneiden des Bildes verwendet wird. Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
imageUrl
|
Die HTTPS-URL des Bildes im Kartenheader. |
imageAltText
|
Der alternative Text dieses Bildes, der als Bedienungshilfe verwendet wird. |
ImageType
Die Form, die zum Zuschneiden des Bildes verwendet wird.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
SQUARE
|
Standardwert. Hiermit wird eine quadratische Maske auf das Bild angewendet. Ein Bild mit 4 x 3 Pixeln wird beispielsweise zu 3 x 3 Pixeln. |
CIRCLE
|
Wendet eine runde Maske auf das Bild an. Ein 4x3-Bild wird beispielsweise zu einem Kreis mit einem Durchmesser von 3. |
Abschnitt
Ein Abschnitt enthält eine Sammlung von Widgets, die vertikal in der angegebenen Reihenfolge gerendert werden.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "header": string, "widgets": [ { object ( |
Felder | |
---|---|
header
|
Text, der oben in einem Abschnitt angezeigt wird. Unterstützt einfachen HTML-formatierten Text. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren. |
widgets[]
|
Alle Widgets in diesem Abschnitt. Muss mindestens ein Widget enthalten. |
collapsible
|
Gibt an, ob dieser Abschnitt minimierbar ist. In minimierten Abschnitten sind einige oder alle Widgets ausgeblendet. Nutzer können den Abschnitt maximieren, um die ausgeblendeten Widgets zu sehen. Klicken Sie dazu auf Mehr anzeigen. Nutzer können die Widgets wieder ausblenden, indem sie auf Weniger anzeigen klicken.
Geben Sie |
uncollapsibleWidgetsCount
|
Die Anzahl der nicht minimierbaren Widgets, die auch dann sichtbar bleiben, wenn ein Bereich minimiert ist.
Wenn ein Abschnitt beispielsweise fünf Widgets und das Widget
|
collapseControl
|
Optional. Legen Sie die Schaltfläche zum Maximieren/Minimieren des Bereichs fest. Diese Schaltfläche wird nur angezeigt, wenn der Bereich minimierbar ist. Ist dieses Feld nicht festgelegt, wird die Standardschaltfläche verwendet. Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
Widget
Jede Karte besteht aus Widgets.
Ein Widget ist ein zusammengesetztes Objekt, das Text, Bilder, Schaltflächen oder andere Objekttypen darstellen kann.
JSON-Darstellung |
---|
{ "horizontalAlignment": enum ( |
Felder | |
---|---|
horizontalAlignment
|
Gibt an, ob Widgets links, rechts oder Mitte einer Spalte ausgerichtet werden. |
Union-Feld
data Ein Widget kann nur eines der folgenden Elemente haben. Sie können mehrere Widget-Felder verwenden, um mehr Elemente anzuzeigen.
data
kann nur einer der folgenden Werte sein:
|
|
textParagraph
|
Zeigt einen Textabschnitt an. Unterstützt einfachen HTML-formatierten Text. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren Durch die folgende JSON-Datei wird beispielsweise ein fett formatierter Text erstellt:
|
image
|
Zeigt ein Bild an. Die folgende JSON-Datei erstellt beispielsweise ein Bild mit alternativem Text:
|
decoratedText
|
Ein Textelement mit Verzierungen. Mit der folgenden JSON-Datei wird beispielsweise ein bearbeitetes Text-Widget erstellt, das die E-Mail-Adresse anzeigt:
|
buttonList
|
Eine Liste mit Schaltflächen. Mit dem folgenden JSON-Code werden beispielsweise zwei Schaltflächen erstellt. Die erste ist eine blaue Textschaltfläche und die zweite eine Bildschaltfläche, die einen Link öffnet:
|
textInput
|
Ein Textfeld, in das Nutzer etwas eingeben können. Mit dem folgenden JSON-Code wird beispielsweise eine Texteingabe für eine E-Mail-Adresse erstellt:
Als weiteres Beispiel erstellt die folgende JSON-Datei eine Texteingabe für eine Programmiersprache mit statischen Vorschlägen:
|
selectionInput
|
Zeigt ein Auswahlsteuerelement an, mit dem Nutzer Elemente auswählen können. Auswahlsteuerelemente können Kästchen, Optionsfelder, Schalter oder Drop-down-Menüs sein. Mit dem folgenden JSON-Code wird beispielsweise ein Drop-down-Menü erstellt, über das Nutzer eine Größe auswählen können:
|
dateTimePicker
|
Zeigt ein Widget an, über das Nutzer ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit eingeben können. Im folgenden JSON-Beispiel wird beispielsweise eine Datumsauswahl erstellt, um einen Termin zu planen:
|
divider
|
Zeigt eine horizontale Trennlinie zwischen den Widgets an. Die folgende JSON-Datei erstellt beispielsweise eine Trennlinie:
|
grid
|
Zeigt ein Raster mit einer Sammlung von Elementen an. Ein Raster unterstützt eine beliebige Anzahl von Spalten und Elementen. Die Anzahl der Zeilen wird durch die Obergrenzen der Anzahl der Elemente geteilt durch die Anzahl der Spalten bestimmt. Ein Raster mit 10 Elementen und 2 Spalten hat 5 Zeilen. Ein Raster mit 11 Elementen und 2 Spalten hat 6 Zeilen. Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. Die folgende JSON erstellt beispielsweise ein zweispaltiges Raster mit einem einzelnen Element:
|
columns
|
Es werden bis zu zwei Spalten angezeigt.
Wenn Sie mehr als zwei Spalten einfügen oder Zeilen verwenden möchten, verwenden Sie die Methode
Mit der folgenden JSON-Datei werden beispielsweise zwei Spalten erstellt, die jeweils Textabsätze enthalten:
|
chipList
|
Eine Liste mit Chips. Mit der folgenden JSON-Datei werden beispielsweise zwei Chips erstellt. Der erste ist ein Textchip und der zweite ein Symbolchip, über den ein Link geöffnet wird:
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
TextParagraph
Ein Textabschnitt, der formatiert werden kann. Ein Beispiel in Google Chat-Apps finden Sie unter Fügen Sie einen Absatz mit formatiertem Text hinzu. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "text": string, "maxLines": integer } |
Felder | |
---|---|
text
|
Der Text, der im Widget angezeigt wird. |
maxLines
|
Die maximale Anzahl von Textzeilen, die im Widget angezeigt werden. Überschreitet der Text die angegebene maximale Zeilenanzahl, wird der überschüssige Inhalt hinter einem Mehr anzeigen Schaltfläche. Wenn der Text gleich oder kürzer als die angegebene maximale Zeilenanzahl ist, wird ein Mehr anzeigen wird nicht angezeigt. Der Standardwert ist 0, sodass der gesamte Kontext angezeigt wird. Negative Werte werden ignoriert. Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
Bild
Ein Bild, das durch eine URL angegeben wird und ein
onClick
Aktion ausführen. Ein Beispiel finden Sie unter
Fügen Sie ein Bild hinzu.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Felder | |
---|---|
imageUrl
|
Die HTTPS-URL, auf der das Bild gehostet wird. Beispiel:
|
onClick
|
Wenn ein Nutzer auf das Bild klickt, wird diese Aktion ausgelöst. |
altText
|
Der alternative Text dieses Bildes, der als Bedienungshilfe verwendet wird. |
OnClick
Stellt dar, wie eine Reaktion erfolgen soll, wenn Nutzer auf ein interaktives Element auf einer Karte, z. B. eine Schaltfläche, klicken.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
|
|
action
|
Wenn angegeben, wird eine Aktion dadurch ausgelöst.
|
openLink
|
Falls angegeben,
|
openDynamicLinkAction
|
Diese Aktion wird durch ein Add-on ausgelöst, wenn mit der Aktion ein Link geöffnet werden muss. Dies unterscheidet sich von der
Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
card
|
Wenn angegeben, wird nach dem Klicken eine neue Karte in den Stapel verschoben. Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
overflowMenu
|
Falls angegeben,
|
Aktion
Eine Aktion, die das Verhalten beim Senden des Formulars beschreibt. Sie können beispielsweise ein Apps Script-Skript aufrufen, um das Formular zu verarbeiten. Wenn die Aktion ausgelöst wird, werden die Formularwerte an den Server gesendet.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "function": string, "parameters": [ { object ( |
Felder | |
---|---|
function
|
Eine benutzerdefinierte Funktion, die aufgerufen wird, wenn auf das enthaltene Element geklickt oder es anderweitig aktiviert wird. Anwendungsbeispiele: Formulardaten lesen |
parameters[]
|
Liste der Aktionsparameter. |
loadIndicator
|
Gibt den Ladeindikator an, der angezeigt wird, während die Aktion ausgeführt wird. |
persistValues
|
Gibt an, ob Formularwerte nach der Aktion bestehen bleiben. Der Standardwert ist
Wenn
Wenn
|
interaction
|
Optional. Erforderlich beim Öffnen eines dialog eingegeben. Was als Reaktion auf eine Interaktion mit einem Nutzer geschehen soll, z. B. wenn ein Nutzer auf eine Schaltfläche in einer Kartennachricht klickt.
Andernfalls führt die App wie gewohnt eine
Durch die Angabe eines
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
requiredWidgets[]
|
Optional. Füllen Sie diese Liste mit den Namen der Widgets, die diese Aktion für eine gültige Einreichung benötigt.
Wenn die hier aufgeführten Widgets beim Aufrufen dieser Aktion keinen Wert aufweisen, wird die Formularübermittlung abgebrochen. Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
allWidgetsAreRequired
|
Optional. Wenn dies wahr ist, gelten für diese Aktion alle Widgets als erforderlich.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
ActionParameter
Liste der Stringparameter, die beim Aufrufen der Aktionsmethode angegeben werden sollen. Betrachten Sie zum Beispiel drei Schaltflächen für die Schlummerfunktion: "Jetzt pausieren", "Schlummern an einem Tag" und "Schlummern für nächste Woche". Sie können
action method = snooze()
und übergeben den Typ und die Zeit für die Schlummerfunktion in der Liste der Stringparameter.
Weitere Informationen finden Sie unter
CommonEventObject
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "key": string, "value": string } |
Felder | |
---|---|
key
|
Der Name des Parameters für das Aktionsskript. |
value
|
Wert des Parameters. |
LoadIndicator
Gibt die Fortschrittsanzeige an, die während der Ausführung der Aktion angezeigt wird.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
SPINNER
|
Ein rotierendes Ladesymbol wird angezeigt, wenn der Inhalt geladen wird. |
NONE
|
Es wird nichts angezeigt. |
Interaktion
Optional. Erforderlich, wenn ein Dialogfeld geöffnet wird.
Was als Reaktion auf eine Interaktion mit einem Nutzer geschehen soll, z. B. wenn ein Nutzer auf eine Schaltfläche in einer Kartennachricht klickt.
Wenn keine Angabe erfolgt, antwortet die Anwendung mit dem folgenden Befehl:
action
wie das Öffnen eines Links oder das Ausführen einer Funktion.
Durch die Angabe eines
interaction
, kann die App auf besondere interaktive Weise reagieren. Wenn Sie beispielsweise
interaction
bis
OPEN_DIALOG
, kann die App Folgendes öffnen:
dialog dargestellt.
Wenn diese Option angegeben ist, wird keine Ladeanzeige angezeigt. Wenn dies für ein Add-on angegeben ist, wird die gesamte Karte entfernt und im Client wird nichts angezeigt.
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
Enums | |
---|---|
INTERACTION_UNSPECIFIED
|
Standardwert. Die
action
wie gewohnt ausgeführt.
|
OPEN_DIALOG
|
Öffnet ein dialog ist eine kartenbasierte Oberfläche im Fenstermodus, über die Chat-Apps mit Nutzern interagieren. Wird nur von Chat-Apps als Reaktion auf Schaltflächenklicks auf Kartennachrichten unterstützt. Wenn für ein Add-on angegeben, wird die gesamte Karte entfernt und im Client wird nichts angezeigt. Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons. |
OpenLink
Stellt ein
onClick
das einen Hyperlink öffnet.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "url": string, "openAs": enum ( |
Felder | |
---|---|
url
|
Die zu öffnende URL. |
openAs
|
So öffnen Sie einen Link. Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps. |
onClose
|
Ob der Kunde einen Link nach dem Öffnen vergisst oder ihn bis zum Schließen des Fensters beobachtet. Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
OpenAs
Wenn ein
OnClick
-Aktion öffnet einen Link, dann kann der Client diesen entweder als Fenster in voller Größe (wenn dieser Frame vom Client verwendet wird) oder als Overlay (z. B. ein Popup-Fenster) öffnen. Die Implementierung hängt von den Funktionen der Clientplattform ab. Der ausgewählte Wert wird möglicherweise ignoriert, wenn er vom Client nicht unterstützt wird.
FULL_SIZE
wird von allen Clients unterstützt.
Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps.
Enums | |
---|---|
FULL_SIZE
|
Der Link wird in voller Größe geöffnet (wenn dieser Frame vom Client verwendet wird). |
OVERLAY
|
Der Link wird als Overlay geöffnet, z. B. als Pop-up-Fenster. |
OnClose
Was passiert, wenn ein Link von einem
OnClick
abgeschlossen ist.
Die Implementierung hängt von den Funktionen der Clientplattform ab. Beispielsweise kann ein Webbrowser einen Link in einem Pop-up-Fenster mit einem
OnClose
-Handler.
Wenn beides
OnOpen
und
OnClose
Handler festgelegt sind und die Client-Plattform
nicht beide Werte unterstützt,
OnClose
hat Vorrang.
Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps.
Enums | |
---|---|
NOTHING
|
Standardwert. Die Karte wird nicht aufgeladen. passiert nichts. |
RELOAD
|
Lädt die Karte neu, nachdem das untergeordnete Fenster geschlossen wurde.
In Verbindung mit |
OverflowMenu
Ein Widget, das ein Pop-up-Menü mit einer oder mehreren Aktionen enthält, die Nutzer ausführen können. Beispiel: Anzeige von nicht primären Aktionen in einer Karte. Sie können dieses Widget verwenden, wenn der verfügbare Platz für Aktionen nicht ausreicht. Geben Sie dieses Widget zur Verwendung in der
OnClick
unterstützen. Beispiel: In einer
Button
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"items": [
{
object (
|
Felder | |
---|---|
items[]
|
Erforderlich. Die Liste der Menüoptionen. |
OverflowMenuItem
Eine Option, die Nutzer in einem Dreipunkt-Menü aufrufen können.
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "startIcon": { object ( |
Felder | |
---|---|
startIcon
|
Das vor dem Text angezeigte Symbol |
text
|
Erforderlich. Der Text, mit dem der Artikel für Nutzer identifiziert oder beschrieben wird. |
onClick
|
Erforderlich. Die Aktion, die ausgeführt wird, wenn eine Menüoption ausgewählt wird. Dieses
|
disabled
|
Gibt an, ob die Menüoption deaktiviert ist. Die Standardeinstellung ist "false". |
Symbol
Ein Symbol, das in einem Widget auf einer Karte angezeigt wird. Ein Beispiel in Google Chat-Apps finden Sie unter Symbol hinzufügen:
Unterstützt vordefinierte und benutzerdefinierte Symbole.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "altText": string, "imageType": enum ( |
Felder | |
---|---|
altText
|
Optional. Eine Beschreibung des Symbols, das für Barrierefreiheit verwendet wird. Wenn kein Wert angegeben ist, wird der Standardwert
Wenn das Symbol in einem |
imageType
|
Der auf das Bild angewendete Zuschnittsstil. In einigen Fällen kann das Anwenden einer
|
Union-Feld
icons Das Symbol, das im Widget auf der Karte angezeigt wird.
icons darf nur einen der folgenden Werte haben:
|
|
knownIcon
|
Rufen Sie eines der integrierten Symbole von Google Workspace auf.
Wenn beispielsweise ein Flugzeugsymbol angezeigt werden soll, geben Sie
Eine vollständige Liste der unterstützten Symbole finden Sie unter integrierten Symbolen hinzufügen. |
iconUrl
|
Ein benutzerdefiniertes Symbol anzeigen, das unter einer HTTPS-URL gehostet wird. Beispiel:
Folgende Dateitypen werden unterstützt:
|
materialIcon
|
Zeigen Sie eine der Material-Symbole von Google: Um beispielsweise eine Kästchensymbol, verwenden Sie
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons. |
MaterialIcon
A Material-Symbol von Google mit über 2.500 Optionen.
Um beispielsweise eine Kästchensymbol mit individueller Gewichtung und Note schreiben Sie Folgendes:
{
"name": "check_box",
"fill": true,
"weight": 300,
"grade": -25
}
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "name": string, "fill": boolean, "weight": integer, "grade": integer } |
Felder | |
---|---|
name
|
Der im Google Material-Symbol definierte Symbolname, z. B. |
fill
|
Gibt an, ob das Symbol gefüllt wird. Der Standardwert ist "false". Eine Vorschau der verschiedenen Symboleinstellungen finden Sie unter Google-Schriftarten und passen Sie die Einstellungen Anpassen. |
weight
|
Die Strichstärke des Symbols. Wählen Sie eine der folgenden Optionen aus: {100, 200, 300, 400, 500, 600, 700}. Wenn nicht vorhanden, ist der Standardwert 400. Wenn ein anderer Wert angegeben wird, wird der Standardwert verwendet. Eine Vorschau der verschiedenen Symboleinstellungen finden Sie unter Google-Schriftarten und passen Sie die Einstellungen Anpassen. |
grade
|
Gewicht und Grad wirken sich auf die Stärke eines Symbols aus. Anpassungen der Noten sind detaillierter als Anpassungen der Gewichtung und wirken sich nur geringfügig auf die Größe des Symbols aus. Wählen Sie {-25, 0, 200} aus. Wenn nicht vorhanden, ist der Standardwert 0. Wenn ein anderer Wert angegeben wird, wird der Standardwert verwendet. Eine Vorschau der verschiedenen Symboleinstellungen finden Sie unter Google-Schriftarten und passen Sie die Einstellungen Anpassen. |
DecoratedText
Ein Widget, das Text mit optionalen Dekorationen anzeigt, z. B. mit einem Label über oder unter dem Text, einem Symbol vor dem Text, einem Auswahl-Widget oder einer Schaltfläche nach dem Text. Ein Beispiel in Google Chat-Apps finden Sie unter Anzeigetext mit dekorativem Text
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "icon": { object ( |
Felder | |
---|---|
icon
|
Zugunsten von
|
startIcon
|
Das vor dem Text angezeigte Symbol |
topLabel
|
Der oben angezeigte Text
|
text
|
Erforderlich. Der Haupttext. Unterstützt einfache Formatierung. Weitere Informationen zum Formatieren von Text finden Sie unter Text in Google Chat-Apps formatieren und Text in Google Workspace-Add-ons formatieren |
wrapText
|
Die Einstellung für den Textumbruch. Wenn
Gilt nur für
|
bottomLabel
|
Der Text, der unten angezeigt wird,
|
onClick
|
Diese Aktion wird ausgelöst, wenn Nutzer auf
|
Union-Feld
control . Eine Schaltfläche, ein Schalter, ein Kästchen oder ein Bild, das rechts neben dem Text im decoratedText -Widget angezeigt wird.
control darf nur einen der folgenden Werte haben:
|
|
button
|
Eine Schaltfläche, auf die Nutzende klicken können, um eine Aktion auszulösen. |
switchControl
|
Ein Schalter-Widget, auf das Nutzer klicken können, um den Status zu ändern und eine Aktion auszulösen. |
endIcon
|
Ein Symbol, das nach dem Text angezeigt wird. Wird unterstützt integriert und benutzerdefiniert Symbole. |
Schaltfläche
Text-, Symbol- oder Text- und Symbolschaltflächen, auf die Nutzende klicken können. Ein Beispiel in Google Chat-Apps finden Sie unter Schaltfläche hinzufügen:
Damit ein Bild zu einer klickbaren Schaltfläche wird, geben Sie eine
(keine
Image
) und legen Sie eine
ImageComponent
onClick
Aktion ausführen.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "text": string, "icon": { object ( |
Felder | |
---|---|
text
|
Der auf der Schaltfläche angezeigte Text. |
icon
|
Ein Symbol, das in der Schaltfläche angezeigt wird. Wenn sowohl |
color
|
Optional. Die Farbe der Schaltfläche. Falls festgelegt,
Um die Farbe der Schaltfläche festzulegen, geben Sie einen Wert für die
Das folgende Beispiel legt die Farbe bei maximaler Intensität auf Rot fest:
Die
|
onClick
|
Erforderlich. Die auszuführende Aktion, wenn ein Nutzer auf die Schaltfläche klickt, z. B. das Öffnen eines Hyperlinks oder das Ausführen einer benutzerdefinierten Funktion. |
disabled
|
Wenn
|
altText
|
Der alternative Text, der für Barrierefreiheit verwendet wird. Legen Sie einen beschreibenden Text fest, der die Nutzer über die Funktion der Schaltfläche informiert. Wenn eine Schaltfläche beispielsweise einen Hyperlink öffnet, könnten Sie Folgendes schreiben: „Öffnet einen neuen Browsertab und wechselt zur Google Chat-Entwicklerdokumentation unter https://developers.google.com/workspace/chat". |
type
|
Optional. Die Art einer Schaltfläche. Wenn kein Wert festgelegt ist, wird standardmäßig der
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
Farbe
Ermöglicht die Darstellung einer Farbe im RGBA-Farbraum. Diese Darstellung ist auf die einfache Konvertierung in und aus Farbdarstellungen in verschiedenen Sprachen statt auf Kompaktheit ausgelegt. Die Felder dieser Darstellung können beispielsweise einfach dem Konstruktor von
java.awt.Color
in Java; kann auch einfach dem UIColor-Tool
+colorWithRed:green:blue:alpha
in iOS verwenden: und kann mit wenig Aufwand in ein CSS-Format
rgba()
in JavaScript verwenden.
Diese Referenzseite enthält keine Informationen zum absoluten Farbraum, der zur Interpretation des RGB-Werts verwendet werden sollte, z. B. sRGB, Adobe RGB, DCI-P3 und BT.2020. Standardmäßig sollte in Anwendungen der sRGB-Farbraum verwendet werden.
Wenn entschieden werden muss, ob zwei Farben gleich sind, behandeln Implementierungen, sofern nicht anders dokumentiert, zwei Farben als gleich, wenn sich alle Rot-, Grün-, Blau- und Alphawerte jeweils um höchstens 1e-5
unterscheiden.
Beispiel (Java):
import com.google.type.Color;
// ...
public static java.awt.Color fromProto(Color protocolor) {
float alpha = protocolor.hasAlpha()
? protocolor.getAlpha().getValue()
: 1.0;
return new java.awt.Color(
protocolor.getRed(),
protocolor.getGreen(),
protocolor.getBlue(),
alpha);
}
public static Color toProto(java.awt.Color color) {
float red = (float) color.getRed();
float green = (float) color.getGreen();
float blue = (float) color.getBlue();
float denominator = 255.0;
Color.Builder resultBuilder =
Color
.newBuilder()
.setRed(red / denominator)
.setGreen(green / denominator)
.setBlue(blue / denominator);
int alpha = color.getAlpha();
if (alpha != 255) {
result.setAlpha(
FloatValue
.newBuilder()
.setValue(((float) alpha) / denominator)
.build());
}
return resultBuilder.build();
}
// ...
Beispiel (iOS/Obj-C):
// ...
static UIColor* fromProto(Color* protocolor) {
float red = [protocolor red];
float green = [protocolor green];
float blue = [protocolor blue];
FloatValue* alpha_wrapper = [protocolor alpha];
float alpha = 1.0;
if (alpha_wrapper != nil) {
alpha = [alpha_wrapper value];
}
return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
}
static Color* toProto(UIColor* color) {
CGFloat red, green, blue, alpha;
if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
return nil;
}
Color* result = [[Color alloc] init];
[result setRed:red];
[result setGreen:green];
[result setBlue:blue];
if (alpha <= 0.9999) {
[result setAlpha:floatWrapperWithValue(alpha)];
}
[result autorelease];
return result;
}
// ...
Beispiel (JavaScript):
// ...
var protoToCssColor = function(rgb_color) {
var redFrac = rgb_color.red || 0.0;
var greenFrac = rgb_color.green || 0.0;
var blueFrac = rgb_color.blue || 0.0;
var red = Math.floor(redFrac * 255);
var green = Math.floor(greenFrac * 255);
var blue = Math.floor(blueFrac * 255);
if (!('alpha' in rgb_color)) {
return rgbToCssColor(red, green, blue);
}
var alphaFrac = rgb_color.alpha.value || 0.0;
var rgbParams = [red, green, blue].join(',');
return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};
var rgbToCssColor = function(red, green, blue) {
var rgbNumber = new Number((red << 16) | (green << 8) | blue);
var hexString = rgbNumber.toString(16);
var missingZeros = 6 - hexString.length;
var resultBuilder = ['#'];
for (var i = 0; i < missingZeros; i++) {
resultBuilder.push('0');
}
resultBuilder.push(hexString);
return resultBuilder.join('');
};
// ...
JSON-Darstellung |
---|
{ "red": number, "green": number, "blue": number, "alpha": number } |
Felder | |
---|---|
red
|
Der Rotanteil der Farbe als Wert im Intervall [0, 1]. |
green
|
Der Grünanteil der Farbe als Wert im Intervall [0, 1]. |
blue
|
Der Blauanteil der Farbe als Wert im Intervall [0, 1]. |
alpha
|
Der Anteil dieser Farbe, der auf den Pixel angewendet werden soll. Die endgültige Pixelfarbe wird durch folgende Gleichung definiert:
Der Wert 1,0 entspricht einer soliden Farbdarstellung, während die Farbe bei einem Wert von 0,0 vollständig transparent ist. Dabei wird anstelle eines einfachen Float-Skalarwerts eine Wrapper-Nachricht verwendet, sodass zwischen einem Standardwert und dem zurückgesetzten Wert unterschieden werden kann. Wenn keine Angabe gemacht wird, wird dieses Farbobjekt als Volltonfarbe gerendert, so als ob dem Alphawert explizit der Wert 1,0 zugewiesen worden wäre. |
Typ
Optional. Die
Typ
einer Schaltfläche. Wenn
color
festgelegt ist, wird der Parameter
type
ist gezwungen,
FILLED
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
Enums | |
---|---|
TYPE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
OUTLINED
|
Umrissene Schaltflächen sind Schaltflächen mit mittlerer Betonung. Sie enthalten in der Regel wichtige Aktionen, die nicht die primäre Aktion in einer Chat-App oder einem Add-on sind. |
FILLED
|
Eine ausgefüllte Schaltfläche hat einen Container mit einer durchgehenden Farbe. Sie hat die größte visuelle Wirkung und wird für die wichtige und primäre Aktion in einer Chat-App oder einem Add-on empfohlen. |
FILLED_TONAL
|
Eine gefüllte Schaltfläche mit Farbton ist ein alternativer Mittelweg zwischen gefüllten und umrandeten Schaltflächen. Sie sind nützlich, wenn eine Schaltfläche mit niedrigerer Priorität etwas mehr Betonung erfordert als eine Umrissschaltfläche. |
BORDERLESS
|
Im Standardzustand hat eine Schaltfläche keinen unsichtbaren Container. Sie wird häufig für Aktionen mit der niedrigsten Priorität verwendet, insbesondere wenn mehrere Optionen präsentiert werden. |
SwitchControl
Entweder ein Umschalter oder ein Kontrollkästchen innerhalb eines
decoratedText
Widget.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Nur unterstützt im
decoratedText
Widget.
JSON-Darstellung |
---|
{ "name": string, "value": string, "selected": boolean, "onChangeAction": { object ( |
Felder | |
---|---|
name
|
Der Name, mit dem das Schalter-Widget in einem Formulareingabeereignis identifiziert wird. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
value
|
Der von einem Nutzer eingegebene Wert, der als Teil eines Formulareingabeereignisses zurückgegeben wird. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
selected
|
Wenn |
onChangeAction
|
Die auszuführende Aktion, wenn der Schalterstatus geändert wird, z. B. welche Funktion ausgeführt werden soll. |
controlType
|
Wie der Schalter in der Benutzeroberfläche angezeigt wird. Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
ControlType
Darstellung des Schalters auf der Benutzeroberfläche
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
SWITCH
|
Ein Schalter |
CHECKBOX
|
Zugunsten von
CHECK_BOX
|
CHECK_BOX
|
Ein Kästchen. |
ButtonList
Eine Liste von Schaltflächen, die horizontal angeordnet sind. Ein Beispiel in Google Chat-Apps finden Sie unter Schaltfläche hinzufügen:
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"buttons": [
{
object (
|
Felder | |
---|---|
buttons[]
|
Mehrere Schaltflächen |
TextInput
Ein Feld, in das Nutzer Text eingeben können. Unterstützt Vorschläge und Aktionen bei Änderungen. Ein Beispiel in Google Chat-Apps finden Sie unter Fügen Sie ein Feld hinzu, in das Nutzer Text eingeben können.
Chat-Apps empfangen und können den Wert des eingegebenen Textes während der Formulareingabe verarbeiten. Weitere Informationen zum Arbeiten mit Formularinputs finden Sie unter Formulardaten empfangen.
Wenn Sie nicht definierte oder abstrakte Daten von Nutzenden erfassen müssen, verwenden Sie eine Texteingabe. Wenn Sie definierte oder aufgezählte Daten von Nutzern erheben möchten, verwenden Sie das SelectionInput
-Widget.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "name": string, "label": string, "hintText": string, "value": string, "type": enum ( |
Felder | |
---|---|
name
|
Der Name, mit dem die Texteingabe in einem Formulareingabeereignis identifiziert wird. Weitere Informationen zum Arbeiten mit Formularinputs finden Sie unter Formulardaten empfangen. |
label
|
Der Text, der in der Benutzeroberfläche über dem Texteingabefeld angezeigt wird.
Geben Sie Text an, der den Nutzern hilft, die für Ihre App erforderlichen Informationen einzugeben. Wenn Sie beispielsweise nach dem Namen einer Person fragen, aber ausdrücklich den Nachnamen benötigen, schreiben Sie
Erforderlich, wenn
|
hintText
|
Text, der unter dem Texteingabefeld angezeigt wird und Nutzer auffordert, einen bestimmten Wert einzugeben. Dieser Text ist immer sichtbar.
Erforderlich, wenn
|
value
|
Der von einem Nutzer eingegebene Wert, der als Teil eines Formulareingabeereignisses zurückgegeben wird. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
type
|
Wie ein Texteingabefeld in der Benutzeroberfläche angezeigt wird. Beispielsweise, ob es sich um ein einzelnes oder ein mehrzeiliges Feld handelt. |
onChangeAction
|
Vorgehensweise bei einer Änderung im Texteingabefeld Beispiel: Ein Nutzer fügt dem Feld etwas hinzu oder löscht Text. Beispiele für auszuführende Aktionen sind das Ausführen einer benutzerdefinierten Funktion oder das Öffnen einer dialog in Google Chat. |
initialSuggestions
|
Vorgeschlagene Werte, die Nutzer eingeben können. Diese Werte werden angezeigt, wenn Nutzende in das Texteingabefeld klicken. Während Nutzer etwas eingeben, werden die vorgeschlagenen Werte dynamisch gefiltert, um den eingegebenen Text zu berücksichtigen.
Ein Texteingabefeld für eine Programmiersprache könnte beispielsweise Java, JavaScript, Python und C++ vorschlagen. Wenn Nutzer mit der Eingabe beginnen
Vorgeschlagene Werte helfen Nutzern, Werte einzugeben, die für Ihre App sinnvoll sind. Wenn auf JavaScript verwiesen wird, geben einige Nutzer
Wenn angegeben,
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
autoCompleteAction
|
Optional. Geben Sie an, welche Aktion ausgeführt werden soll, wenn das Texteingabefeld Vorschläge für Nutzer enthält, die damit interagieren.
Wenn kein Wert angegeben ist, werden die Vorschläge durch
Wenn angegeben, führt die App die hier angegebene Aktion aus, z. B. das Ausführen einer benutzerdefinierten Funktion. Verfügbar für Google Workspace-Add-ons, nicht für Google Chat-Apps. |
validation
|
Geben Sie die für dieses Textfeld erforderliche Validierung an.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
placeholderText
|
Text, der im Texteingabefeld erscheint, wenn das Feld leer ist. Verwenden Sie diesen Text, um Nutzer zur Eingabe eines Werts aufzufordern. Beispiel: Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons. |
Typ
Wie ein Texteingabefeld in der Benutzeroberfläche angezeigt wird. Das kann beispielsweise ein einzeiliges Eingabefeld oder eine mehrzeilige Eingabe sein. Wenn
initialSuggestions
angegeben ist,
type
ist immer
SINGLE_LINE
, auch wenn folgendes festgelegt ist:
MULTIPLE_LINE
.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
SINGLE_LINE
|
Das Texteingabefeld hat eine feste Höhe von einer Zeile. |
MULTIPLE_LINE
|
Das Texteingabefeld hat eine feste Höhe von mehreren Zeilen. |
RenderActions
Eine Reihe von Rendering-Anweisungen, die eine Karte auffordern, eine Aktion auszuführen, oder die Add-on-Host-App oder die Chat-App anweisen, eine appspezifische Aktion auszuführen.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Felder | |
---|---|
action |
Aktion
Felder | |
---|---|
navigations[] |
Angezeigte Karten verschieben oder aktualisieren. |
Vorschläge
Vorgeschlagene Werte, die Nutzer eingeben können. Diese Werte werden angezeigt, wenn Nutzer in das Textfeld klicken. Während die Nutzer tippen, werden die vorgeschlagenen Werte dynamisch gefiltert, damit sie den Eingaben der Nutzer entsprechen.
Ein Texteingabefeld für eine Programmiersprache könnte beispielsweise Java, JavaScript, Python und C++ vorschlagen. Wenn Nutzer mit der Eingabe beginnen
Jav
, die Liste der anzuzeigenden Vorschläge-Filter
Java
und
JavaScript
Vorgeschlagene Werte helfen Nutzern, Werte einzugeben, die für Ihre App sinnvoll sind. Wenn auf JavaScript verwiesen wird, geben einige Nutzer
javascript
und weitere
java script
. Vorschlagen
JavaScript
wie Nutzer mit Ihrer App interagieren.
Wenn angegeben,
TextInput.type
ist immer
SINGLE_LINE
, auch wenn folgendes festgelegt ist:
MULTIPLE_LINE
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"items": [
{
object (
|
Felder | |
---|---|
items[]
|
Eine Liste mit Vorschlägen, die für Empfehlungen zur automatischen Vervollständigung in Texteingabefeldern verwendet werden. |
SuggestionItem
Ein vorgeschlagener Wert, den Nutzer in ein Texteingabefeld eingeben können.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
|
|
text
|
Der Wert einer vorgeschlagenen Eingabe für ein Texteingabefeld. Dies entspricht den Angaben, die Nutzer selbst eingeben. |
Validierung
Die erforderlichen Daten zur Validierung des mit ihm verbundenen Widgets.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{
"characterLimit": integer,
"inputType": enum (
|
Felder | |
---|---|
characterLimit
|
Geben Sie die Zeichenbeschränkung für Texteingabe-Widgets an. Beachten Sie, dass dies nur für die Texteingabe verwendet und bei anderen Widgets ignoriert wird.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
inputType
|
Geben Sie den Typ der Eingabe-Widgets an.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
InputType
Der Typ des Eingabe-Widgets.
Enums | |
---|---|
INPUT_TYPE_UNSPECIFIED
|
Nicht definierter Typ. Nicht verwenden. |
TEXT
|
Normaler Text, in dem alle Zeichen zulässig sind. |
INTEGER
|
Ein ganzzahliger Wert. |
FLOAT
|
Ein Gleitkommawert. |
EMAIL
|
Eine E-Mail-Adresse. |
EMOJI_PICKER
|
Ein Emoji, das aus der vom System bereitgestellten Emoji-Auswahl ausgewählt wurde. |
SelectionInput
Ein Widget, das ein oder mehrere UI-Elemente erstellt, die Nutzer auswählen können. Zum Beispiel ein Drop-down-Menü oder Kästchen. Mit diesem Widget können Sie Daten erfassen, die vorhergesagt oder aufgezählt werden können. Ein Beispiel für Google Chat-Apps finden Sie unter Auswahlbare UI-Elemente hinzufügen.
Chat-Apps können den Wert von Elementen verarbeiten, die Nutzer auswählen oder eingeben. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen
Um undefinierte oder abstrakte Daten von Nutzenden zu sammeln, verwenden Sie die
TextInput
Widget.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "name": string, "label": string, "type": enum ( |
Felder | |
---|---|
name
|
Erforderlich. Der Name, der die Auswahleingabe in einem Formulareingabeereignis kennzeichnet. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
label
|
Der Text, der in der Benutzeroberfläche über dem Auswahleingabefeld angezeigt wird. Geben Sie Text ein, der dem Nutzer die Eingabe der Informationen erleichtert, die Ihre App benötigt. Wenn Nutzer beispielsweise die Dringlichkeit eines Arbeitstickets aus einem Drop-down-Menü auswählen, kann das Label „Dringlichkeit“ lauten. oder „Dringlichkeit auswählen“. |
type
|
Die Art der Elemente, die Nutzern in einem
|
items[]
|
Ein Array mit auswählbaren Elementen. Dies kann beispielsweise ein Array von Optionsfeldern oder Kästchen sein. Es werden bis zu 100 Elemente unterstützt. |
onChangeAction
|
Falls angegeben, wird das Formular gesendet, wenn sich die Auswahl ändert. Wenn nicht angegeben, musst du eine separate Schaltfläche zum Senden des Formulars angeben. Weitere Informationen zum Arbeiten mit Formularinputs finden Sie unter Formulardaten empfangen. |
multiSelectMaxSelectedItems
|
Bei Menüs mit Mehrfachauswahl die maximale Anzahl von Elementen, die ein Nutzer auswählen kann. Der Mindestwert beträgt 1 Artikel. Wenn keine Vorgabe erfolgt, werden standardmäßig 3 Elemente verwendet. |
multiSelectMinQueryLength
|
Bei Mehrfachauswahl-Menüs die Anzahl der Textzeichen, die ein Nutzer eingibt, bevor die App die automatische Vervollständigung abfragt und vorgeschlagene Elemente im Menü anzeigt. Wenn kein Wert angegeben ist, werden standardmäßig 0 Zeichen für statische Datenquellen und 3 Zeichen für externe Datenquellen verwendet. |
validation
|
Bei Drop-down-Menüs die Validierung für dieses Auswahleingabefeld. Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
Union-Feld
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
|
|
externalDataSource
|
Eine externe Datenquelle, z. B. eine relationale Datenbank. |
platformDataSource
|
Eine Datenquelle aus Google Workspace. |
SelectionType
Das Format für die Elemente, die Nutzer auswählen können. Unterschiedliche Optionen unterstützen unterschiedliche Arten von Interaktionen. Nutzer können beispielsweise mehrere Kästchen anklicken, aber aus einem Drop-down-Menü nur ein Element auswählen.
Jede Auswahleingabe unterstützt einen Auswahltyp. Das Mischen von Kästchen und Schaltern wird beispielsweise nicht unterstützt.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
CHECK_BOX
|
Eine Reihe von Kästchen. Nutzer können ein oder mehrere Kästchen auswählen. |
RADIO_BUTTON
|
Mehrere Optionsfelder. Nutzer können ein Optionsfeld auswählen. |
SWITCH
|
Eine Reihe von Schaltern. Nutzer können einen oder mehrere Schalter aktivieren. |
DROPDOWN
|
Ein Drop-down-Menü. Nutzer können ein Element aus dem Menü auswählen. |
MULTI_SELECT
|
Ein Mehrfachauswahl-Menü für statische oder dynamische Daten. In der Menüleiste wählen Nutzer ein oder mehrere Elemente aus. Nutzer können auch Werte eingeben, um dynamische Daten zu füllen. Wenn Nutzer beispielsweise den Namen eines Google Chat-Bereichs eingeben, wird dieser automatisch vom Widget vorgeschlagen. Wenn Sie Elemente in einem Mehrfachauswahlmenü füllen möchten, können Sie einen der folgenden Datenquellentypen verwenden:
Beispiele für die Implementierung von Menüs mit Mehrfachauswahl finden Sie unter Mehrfachauswahlmenü hinzufügen: Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
SelectionItem
Ein Element, das Nutzer in einer Auswahleingabe auswählen können, z. B. ein Kästchen oder einen Schalter.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "text": string, "value": string, "selected": boolean, "startIconUri": string, "bottomText": string } |
Felder | |
---|---|
text
|
Der Text, mit dem der Artikel für Nutzer identifiziert oder beschrieben wird. |
value
|
Der mit diesem Artikel verknüpfte Wert. Der Client sollte diesen Wert als Eingabewert für das Formular verwenden. Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
selected
|
Gibt an, ob das Element standardmäßig ausgewählt ist. Wenn in der Auswahl nur ein Wert zulässig ist (z. B. für Optionsfelder oder ein Dropdown-Menü), legen Sie dieses Feld nur für ein Element fest. |
startIconUri
|
Bei Menüs mit Mehrfachauswahl wird die URL für das Symbol neben der Option
|
bottomText
|
Bei Menüs mit Mehrfachauswahl wird eine Textbeschreibung oder ein Label unterhalb des
|
PlatformDataSource
Für eine
Widget, das ein Mehrfachauswahl-Menü verwendet, eine Datenquelle aus Google Workspace. Wird zum Füllen von Elementen in einem Mehrfachauswahlmenü verwendet.
SelectionInput
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
data_source . Die Datenquelle.
data_source
kann nur einer der folgenden Werte sein:
|
|
commonDataSource
|
Eine Datenquelle, die von allen Google Workspace-Anwendungen freigegeben wird, z. B. Nutzern in einer Google Workspace-Organisation. |
hostAppDataSource
|
Eine Datenquelle, die für eine Google Workspace-Hostanwendung eindeutig ist, z. B. Gruppenbereiche in Google Chat. Dieses Feld unterstützt die Google API-Clientbibliotheken, ist aber in den Cloud-Clientbibliotheken nicht verfügbar. Weitere Informationen finden Sie unter Installieren Sie die Clientbibliotheken. |
CommonDataSource
Eine Datenquelle, die von allen gemeinsam genutzt wird Google Workspace-Anwendungen.
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
Enums | |
---|---|
UNKNOWN
|
Standardwert. Nicht verwenden. |
USER
|
Google Workspace-Nutzer. Der Nutzer kann nur Nutzer aus seiner Google Workspace-Organisation ansehen und auswählen. |
HostAppDataSourceMarkup
Für eine
Widget, das ein Mehrfachauswahl-Menü verwendet, eine Datenquelle aus einer Google Workspace-Anwendung. Die Datenquelle füllt die Auswahlelemente für das Mehrfachauswahl-Menü mit Daten.
SelectionInput
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
data_source Die Google Workspace-Anwendung, mit der Elemente für ein Mehrfachauswahlmenü ausgefüllt werden.
data_source darf nur einen der folgenden Werte haben:
|
|
chatDataSource
|
Eine Datenquelle aus Google Chat. |
ChatClientDataSourceMarkup
Für eine
Widget, das ein Mehrfachauswahl-Menü verwendet, eine Datenquelle aus Google Chat. Die Datenquelle füllt die Auswahlelemente für das Mehrfachauswahl-Menü mit Daten. Ein Nutzer kann beispielsweise Google Chat-Gruppenbereiche auswählen, in denen er Mitglied ist.
SelectionInput
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
source Die Google Chat-Datenquelle.
source
kann nur einer der folgenden Werte sein:
|
|
spaceDataSource
|
Google Chat-Gruppenbereiche, in denen der Nutzer Mitglied ist. |
SpaceDataSource
Eine Datenquelle, die Google Chat-Gruppenbereiche als Auswahlelemente für ein Mehrfachauswahlmenü enthält. Es werden nur Gruppenbereiche ausgefüllt, in denen der Nutzer Mitglied ist.
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "defaultToCurrentSpace": boolean } |
Felder | |
---|---|
defaultToCurrentSpace
|
Wenn festgelegt auf
|
DateTimePicker
Damit können Nutzer ein Datum, eine Uhrzeit oder beides eingeben. Ein Beispiel in Google Chat-Apps finden Sie unter Nutzer dürfen Datum und Uhrzeit auswählen.
Nutzer können Text eingeben oder die Auswahl verwenden, um Datum und Uhrzeit auszuwählen. Wenn Nutzer ein ungültiges Datum oder eine ungültige Uhrzeit eingeben, wird in der Auswahl eine Fehlermeldung angezeigt, in der sie aufgefordert werden, die Informationen korrekt einzugeben.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "name": string, "label": string, "type": enum ( |
Felder | |
---|---|
name
|
Der Name, mit dem die Weitere Informationen zur Arbeit mit Formulareingaben finden Sie unter Formulardaten abrufen |
label
|
Text, mit dem die Nutzer aufgefordert werden, ein Datum, eine Uhrzeit oder ein Datum und eine Uhrzeit einzugeben. Wenn Nutzende beispielsweise einen Termin vereinbaren, verwenden Sie ein Label wie
|
type
|
Gibt an, ob das Widget die Eingabe eines Datums, einer Uhrzeit oder eines Datums und einer Uhrzeit unterstützt. |
valueMsEpoch
|
Der im Widget angezeigte Standardwert in Millisekunden seit Unix-Epochenzeit.
Geben Sie den Wert basierend auf dem Auswahltyp (
|
timezoneOffsetDate
|
Die Zahl, die den Zeitzonen-Unterschied zu UTC in Minuten angibt. Wenn festgelegt,
|
onChangeAction
|
Wird ausgelöst, wenn der Nutzer auf
Speichern
oder
Löschen
aus der
|
validation
|
Optional. Geben Sie die Validierung an, die für diese Datetimer-Auswahl erforderlich ist.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. |
DateTimePickerType
Das Format für Datum und Uhrzeit im Feld
DateTimePicker
Widget. Legt fest, ob Nutzer ein Datum, eine Uhrzeit oder beides eingeben können.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
DATE_AND_TIME
|
Nutzer geben ein Datum und eine Uhrzeit ein. |
DATE_ONLY
|
Nutzer geben ein Datum ein. |
TIME_ONLY
|
Nutzer geben eine Uhrzeit ein. |
Trennlinie
Dieser Typ hat keine Felder.
Zeigt eine Trennlinie zwischen Widgets als horizontale Linie an. Ein Beispiel für Google Chat-Apps finden Sie unter Horizontale Trennlinie zwischen Widgets hinzufügen.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Die folgende JSON-Datei erstellt beispielsweise eine Trennlinie:
"divider": {}
Raster
Zeigt ein Raster mit einer Sammlung von Elementen an. Elemente dürfen nur Text oder Bilder enthalten. Für responsive Spalten oder wenn Sie mehr als Text oder Bilder einfügen möchten, verwenden Sie
Ein Beispiel für Google Chat-Apps finden Sie unter Raster mit einer Sammlung von Elementen anzeigen.
Columns
Ein Raster unterstützt eine beliebige Anzahl von Spalten und Elementen. Die Anzahl der Zeilen ergibt sich aus den Elementen geteilt durch die Spalten. Ein Raster mit 10 Elementen und 2 Spalten hat 5 Zeilen. Ein Raster mit 11 Elementen und 2 Spalten hat 6 Zeilen.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Mit dem folgenden JSON-Code wird beispielsweise ein Raster mit zwei Spalten und einem einzelnen Element erstellt:
"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"
}
}
}
JSON-Darstellung |
---|
{ "title": string, "items": [ { object ( |
Felder | |
---|---|
title
|
Der Text, der in der Rasterüberschrift angezeigt wird. |
items[]
|
Die Elemente, die im Raster angezeigt werden sollen. |
borderStyle
|
Der Rahmenstil, der auf jedes Rasterelement angewendet werden soll. |
columnCount
|
Die Anzahl der Spalten, die im Raster angezeigt werden sollen. Wenn dieses Feld nicht angegeben ist, wird ein Standardwert verwendet. Dieser Standardwert unterscheidet sich je nachdem, wo das Raster angezeigt wird (Dialogfeld oder Companion). |
onClick
|
Dieser Callback wird von jedem einzelnen Rasterelement wiederverwendet, wobei jedoch die Kennung und der Index des Elements in der Elementliste den Parametern des Callbacks hinzugefügt werden. |
GridItem
Stellt ein Element in einem Rasterlayout dar. Elemente können Text, ein Bild oder sowohl Text als auch ein Bild enthalten.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "id": string, "image": { object ( |
Felder | |
---|---|
id
|
Eine vom Nutzer angegebene Kennung für dieses Rasterelement. Diese Kennung wird im übergeordneten Raster
|
image
|
Das Bild, das im Rasterelement angezeigt wird. |
title
|
Der Titel des Rasterelements. |
subtitle
|
Der Untertitel des Rasterelements. |
layout
|
Das für das Rasterelement zu verwendende Layout. |
ImageComponent
Stellt ein Bild dar.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "imageUri": string, "altText": string, "cropStyle": { object ( |
Felder | |
---|---|
imageUri
|
Die Bild-URL. |
altText
|
Das Bedienungshilfen-Label für das Bild. |
cropStyle
|
Der Zuschneidemodus, der auf das Bild angewendet werden soll. |
borderStyle
|
Der Rahmenstil, der auf das Bild angewendet werden soll. |
ImageCropStyle
Stellt den auf ein Bild angewendeten Zuschnittsstil dar.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
So können Sie beispielsweise ein Seitenverhältnis von 16:9 verwenden:
cropStyle {
"type": "RECTANGLE_CUSTOM",
"aspectRatio": 16/9
}
JSON-Darstellung |
---|
{
"type": enum (
|
Felder | |
---|---|
type
|
Der Erntetyp. |
aspectRatio
|
Das Seitenverhältnis, das verwendet werden soll, wenn die Zuschneideart auf
So können Sie beispielsweise ein Seitenverhältnis von 16:9 verwenden:
|
ImageCropType
Stellt den auf ein Bild angewendeten Zuschnittsstil dar.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
IMAGE_CROP_TYPE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
SQUARE
|
Standardwert. Quadratzuschnitt anwenden. |
CIRCLE
|
Macht einen kreisförmigen Schnitt. |
RECTANGLE_CUSTOM
|
Wählt ein rechteckiges Zuschneiden mit einem benutzerdefinierten Seitenverhältnis aus. Benutzerdefiniertes Seitenverhältnis festlegen mit
aspectRatio
|
RECTANGLE_4_3
|
schneidet einen rechteckigen Ausschnitt mit einem Seitenverhältnis von 4:3 zu. |
BorderStyle
Die Stiloptionen für den Rahmen einer Karte oder eines Widgets, einschließlich Rahmentyp und -farbe.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "type": enum ( |
Felder | |
---|---|
type
|
Der Rahmentyp. |
strokeColor
|
Die zu verwendenden Farben für den Typ
Um die Strichfarbe festzulegen, geben Sie einen Wert für den
Im folgenden Beispiel wird die Farbe beispielsweise auf Rot mit maximaler Intensität festgelegt:
Die
|
cornerRadius
|
Der Eckenradius für den Rahmen. |
BorderType
Stellt die Rahmentypen dar, die auf Widgets angewendet werden.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
BORDER_TYPE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
NO_BORDER
|
Standardwert. Kein Rahmen. |
STROKE
|
Gliederung. |
GridItemLayout
Stellt die verschiedenen Layoutoptionen dar, die für ein Rasterelement verfügbar sind.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
GRID_ITEM_LAYOUT_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
TEXT_BELOW
|
Titel und Untertitel werden unter dem Bild des Rasterelements angezeigt. |
TEXT_ABOVE
|
Titel und Untertitel werden über dem Bild des Rasterelements angezeigt. |
Spalten
Im Columns
-Widget können bis zu zwei Spalten in einer Karte oder einem Dialogfeld angezeigt werden. Sie können Widgets zu jeder Spalte hinzufügen. werden die Widgets in der angegebenen Reihenfolge angezeigt. Ein Beispiel in Google Chat-Apps finden Sie unter
Karten und Dialogfelder in Spalten anzeigen
Die Höhe jeder Spalte wird durch die höhere Spalte bestimmt. Wenn beispielsweise die erste Spalte höher ist als die zweite Spalte, haben beide Spalten die Höhe der ersten Spalte. Da jede Spalte eine unterschiedliche Anzahl von Widgets enthalten kann, können Sie keine Zeilen definieren oder Widgets zwischen den Spalten ausrichten.
Die Spalten werden nebeneinander angezeigt. Sie können die Breite jeder Spalte mithilfe der
HorizontalSizeStyle
ein. Wenn die Bildschirmbreite des Nutzers zu schmal ist, wird die zweite Spalte unter der ersten angezeigt:
- Im Web wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 480 Pixel ist.
- Auf iOS-Geräten wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 300 pt ist.
- Auf Android-Geräten wird die zweite Spalte umgebrochen, wenn die Bildschirmbreite kleiner oder gleich 320 dp ist.
Wenn Sie mehr als zwei Spalten einfügen oder Zeilen verwenden möchten, verwenden Sie die Methode
Widget.
Grid
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons. Zu den Add-on-UIs, die Spalten unterstützen, gehören:
- Das Dialogfeld, das angezeigt wird, wenn Nutzer das Add-on über einen E-Mail-Entwurf öffnen.
- Das Dialogfeld, das angezeigt wird, wenn Nutzer das Add-on über das Menü Anhang hinzufügen in einem Google Kalender-Termin öffnen.
JSON-Darstellung |
---|
{
"columnItems": [
{
object (
|
Felder | |
---|---|
columnItems[]
|
Ein Array von Spalten. Eine Karte oder ein Dialogfeld kann bis zu zwei Spalten enthalten. |
Spalte
Spalte
JSON-Darstellung |
---|
{ "horizontalSizeStyle": enum ( |
Felder | |
---|---|
horizontalSizeStyle
|
Gibt an, wie eine Spalte die Breite der Karte einnimmt. |
horizontalAlignment
|
Gibt an, ob Widgets links, rechts oder Mitte einer Spalte ausgerichtet werden. |
verticalAlignment
|
Gibt an, ob Widgets am oberen, unteren oder mittleren Rand einer Spalte ausgerichtet werden. |
widgets[]
|
Ein Array von Widgets, die in einer Spalte enthalten sind. Widgets werden in der angegebenen Reihenfolge angezeigt. |
HorizontalSizeStyle
Gibt an, wie eine Spalte die Breite der Karte einnimmt. Die Breite jeder Spalte hängt sowohl vom
HorizontalSizeStyle
und die Breite der Widgets in der Spalte.
Enums | |
---|---|
HORIZONTAL_SIZE_STYLE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
FILL_AVAILABLE_SPACE
|
Standardwert. Die Spalte füllt den verfügbaren Platz aus, und zwar bis zu 70% der Kartenbreite. Wenn beide Spalten auf
FILL_AVAILABLE_SPACE , jede Spalte füllt 50% der Fläche aus.
|
FILL_MINIMUM_SPACE
|
Die Spalte füllt den geringsten Platz aus und nicht mehr als 30% der Kartenbreite. |
HorizontalAlignment
Gibt an, ob Widgets links, rechts oder Mitte einer Spalte ausgerichtet werden.
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
Enums | |
---|---|
HORIZONTAL_ALIGNMENT_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
START
|
Standardwert. Richtet Widgets an der Startposition der Spalte aus. Wird bei rechtsläufigen Layouts linksbündig ausgerichtet. Bei linksläufigen Layouts wird sie rechtsbündig ausgerichtet. |
CENTER
|
Richtet Widgets an der Mitte der Spalte aus. |
END
|
Richtet Widgets an der Endposition der Spalte aus. Bei rechtsläufigen Layouts werden Widgets rechts ausgerichtet. Bei Layouts, die von rechts nach links gelesen werden, werden Widgets links ausgerichtet. |
VerticalAlignment
Gibt an, ob Widgets am oberen, unteren oder mittleren Rand einer Spalte ausgerichtet werden.
Enums | |
---|---|
VERTICAL_ALIGNMENT_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
CENTER
|
Standardwert. Richtet Widgets an der Mitte einer Spalte aus. |
TOP
|
Widgets werden oben in einer Spalte ausgerichtet. |
BOTTOM
|
Richtet Widgets am unteren Rand einer Spalte aus. |
Widgets
Die unterstützten Widgets, die Sie in eine Spalte einfügen können.
JSON-Darstellung |
---|
{ // Union field |
Felder | |
---|---|
Union-Feld
|
|
textParagraph
|
|
image
|
|
decoratedText
|
|
buttonList
|
|
textInput
|
|
selectionInput
|
|
dateTimePicker
|
|
chipList
|
|
ChipList
Eine Liste von horizontal angeordneten Chips, die entweder horizontal gescrollt werden oder zur nächsten Zeile springen können.
Verfügbar für Google Chat-Apps, nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "layout": enum ( |
Felder | |
---|---|
layout
|
Angegebenes Layout der Chipliste. |
chips[]
|
Eine Reihe von Chips. |
Layout
Das Layout der Chipliste.
Enums | |
---|---|
LAYOUT_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
WRAPPED
|
Standardwert. Wenn horizontal nicht genügend Platz vorhanden ist, wird von der Chipliste zur nächsten Zeile gewechselt. |
HORIZONTAL_SCROLLABLE
|
Die Chips scrollen horizontal, wenn sie nicht in den verfügbaren Platz passen. |
Chip
Ein Chip mit Text, Symbol oder Text und Symbol, auf den Nutzer klicken können.
Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "icon": { object ( |
Felder | |
---|---|
icon
|
Das Symbolbild. Wenn sowohl |
label
|
Der Text, der im Chip angezeigt wird. |
onClick
|
Optional. Die Aktion, die ausgeführt werden soll, wenn ein Nutzer auf den Chip klickt, z. B. das Öffnen eines Hyperlinks oder das Ausführen einer benutzerdefinierten Funktion. |
enabled
|
Gibt an, ob sich der Chip in einem aktiven Zustand befindet und auf Nutzeraktionen reagiert. Die Standardeinstellung ist |
disabled
|
Gibt an, ob der Chip inaktiv ist und Nutzeraktionen ignoriert werden. Standardeinstellung:
|
altText
|
Der alternative Text, der für Barrierefreiheit verwendet wird. Legen Sie einen beschreibenden Text fest, der Nutzer über die Funktion des Chips informiert. Wenn durch einen Chip beispielsweise ein Hyperlink geöffnet wird, schreiben Sie: „Öffnet einen neuen Browsertab und navigiert zur Google Chat-Entwicklerdokumentation unter https://developers.google.com/workspace/chat". |
CollapseControl
Stellt ein Steuerelement zum Maximieren und Minimieren dar. Verfügbar für Google Chat-Apps und nicht für Google Workspace-Add-ons.
JSON-Darstellung |
---|
{ "horizontalAlignment": enum ( |
Felder | |
---|---|
horizontalAlignment
|
Die horizontale Ausrichtung der Schaltfläche zum Maximieren und Minimieren. |
expandButton
|
Optional. Definieren Sie eine anpassbare Schaltfläche, um den Bereich zu maximieren. Es muss sowohl das Feld "expandButton" als auch das Feld "collapsbutton" festgelegt werden. Nur ein Feldsatz wird nicht wirksam. Ist dieses Feld nicht festgelegt, wird die Standardschaltfläche verwendet. |
collapseButton
|
Optional. Definieren Sie eine anpassbare Schaltfläche, um den Abschnitt zu minimieren. Es muss sowohl das Feld "expandButton" als auch das Feld "collapsbutton" festgelegt werden. Nur ein Feldsatz wird nicht wirksam. Wenn dieses Feld nicht festgelegt ist, wird die Standardschaltfläche verwendet. |
DividerStyle
Der Trennlinienstil einer Karte. Wird derzeit nur für Trennlinien zwischen Kartenabschnitten verwendet.
Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.
Enums | |
---|---|
DIVIDER_STYLE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
SOLID_DIVIDER
|
Standardoption. Einen durchgehenden Trennstrich rendern |
NO_DIVIDER
|
Wenn diese Option festgelegt ist, wird kein Trennstrich gerendert. Durch diesen Stil wird die Trennlinie aus dem Layout vollständig entfernt. Das Ergebnis ist dasselbe, wenn gar keine Trennlinie hinzugefügt wird. |
CardAction
Eine Kartenaktion ist die mit der Karte verknüpfte Aktion. Eine Rechnungskarte kann beispielsweise Aktionen wie das Löschen einer Rechnung, eine E-Mail-Rechnung oder das Öffnen der Rechnung in einem Browser enthalten.
Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps.
JSON-Darstellung |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Felder | |
---|---|
actionLabel
|
Das Label, das als Menüelement für Aktionen angezeigt wird. |
onClick
|
Die
|
DisplayStyle
In Google Workspace-Add-ons wird festgelegt, wie eine Karte angezeigt wird.
Verfügbar für Google Workspace-Add-ons und nicht für Google Chat-Apps.
Enums | |
---|---|
DISPLAY_STYLE_UNSPECIFIED
|
Nicht verwenden. Nicht angegeben |
PEEK
|
Der Header der Karte wird unten in der Seitenleiste angezeigt und verdeckt die aktuelle oberste Karte des Stapels teilweise. Wenn Sie auf den Header klicken, wird die Karte im Kartenstapel geöffnet. Wenn die Karte keine Kopfzeile hat, wird stattdessen eine generierte Kopfzeile verwendet. |
REPLACE
|
Standardwert. Die obere Karte im Stapel wird durch die neue Ansicht ersetzt. |