Scheda
Una scheda è un elemento UI che può contenere widget UI come testo e immagini.
Rappresentazione JSON |
---|
{ "header": { object ( |
Campi | |
---|---|
header
|
L'intestazione della scheda. Un'intestazione di solito contiene un titolo e un'immagine. |
sections[]
|
Le sezioni sono separate da un separatore di linea. |
cardActions[]
|
Le azioni di questa scheda. |
name
|
Nome della carta. |
CardHeader
Rappresentazione JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Campi | |
---|---|
title
|
È necessario specificare il titolo. L'intestazione ha un'altezza fissa: se vengono specificati sia un titolo che un sottotitolo, entrambi occupano una riga. Se viene specificato solo il titolo, questo occupa entrambe le righe. |
subtitle
|
Il sottotitolo dell'intestazione della scheda. |
imageStyle
|
Il tipo di immagine (ad esempio bordo quadrato o bordo circolare). |
imageUrl
|
L'URL dell'immagine nell'intestazione della scheda. |
ImageStyle
Enum | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Bordo quadrato. |
AVATAR
|
Bordo circolare. |
Sezione
Una sezione contiene una raccolta di widget che vengono visualizzati (verticalmente) nell'ordine in cui sono specificati. Su tutte le piattaforme, le schede hanno una larghezza fissa fissa, quindi al momento non sono necessarie le proprietà di layout (ad esempio, mobile).
Rappresentazione JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Campi | |
---|---|
header
|
L'intestazione della sezione. Il testo formattato è supportato. Per ulteriori informazioni sulla formattazione del testo, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace. |
widgets[]
|
Una sezione deve contenere almeno un widget. |
WidgetMarkup
Un widget è un elemento dell'interfaccia utente che presenta testo e immagini.
Rappresentazione JSON |
---|
{ "buttons": [ { object ( |
Campi | |
---|---|
buttons[]
|
Un elenco di pulsanti. Anche i pulsanti
|
Campo unione
data . R
WidgetMarkup
può avere solo uno dei seguenti elementi. Puoi utilizzare più applicazioni
WidgetMarkup
campi per visualizzare più elementi.
data
può essere solo uno dei seguenti:
|
|
textParagraph
|
Visualizza un paragrafo di testo in questo widget. |
image
|
Visualizza un'immagine in questo widget. |
keyValue
|
Visualizza un elemento chiave-valore in questo widget. |
TextParagraph
Un paragrafo di testo. Testo formattato supportato. Per ulteriori informazioni sulla formattazione del testo, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.
Rappresentazione JSON |
---|
{ "text": string } |
Campi | |
---|---|
text
|
|
Immagine
Un'immagine che è specificata da un URL e può avere un
onclick
un'azione.
Rappresentazione JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Campi | |
---|---|
imageUrl
|
L'URL dell'immagine. |
onClick
|
La
|
aspectRatio
|
Le proporzioni dell'immagine (larghezza e altezza). Questo campo ti consente di riservare l'altezza giusta per l'immagine in attesa del suo caricamento. Questa funzione non intende sostituire le proporzioni integrate dell'immagine. Se il criterio non viene configurato, il server lo riempie precaricando l'immagine. |
OnClick
Un
onclick
(ad esempio, "apri un link").
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
action
|
Questo attiva un'azione del modulo
|
openLink
|
Questo
|
FormAction
Un'azione del modulo descrive il comportamento quando viene inviato. Ad esempio, puoi richiamare Apps Script per gestire il modulo.
Rappresentazione JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Campi | |
---|---|
actionMethodName
|
Il nome del metodo viene utilizzato per identificare quale parte del modulo ha attivato l'invio del modulo. Queste informazioni vengono riportate nell'app Chat come parte dell'evento di clic sulla scheda. Puoi utilizzare lo stesso nome di metodo per diversi elementi che attivano un comportamento comune. |
parameters[]
|
Elenco dei parametri di azione. |
ActionParameter
Elenco di parametri stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, considera tre pulsanti per posticiparla: Posticipa ora, Posticipa un giorno e Posticipa la prossima settimana. Potresti usare
action method = snooze()
, passando il tipo e il tempo di posticipazione nell'elenco dei parametri stringa.
Rappresentazione JSON |
---|
{ "key": string, "value": string } |
Campi | |
---|---|
key
|
Il nome del parametro per l'action script. |
value
|
Il valore del parametro. |
OpenLink
Un link che apre una nuova finestra.
Rappresentazione JSON |
---|
{ "url": string } |
Campi | |
---|---|
url
|
L'URL da aprire. |
KeyValue
Un elemento UI contiene una chiave (etichetta) e un valore (contenuti). Questo elemento può anche contenere azioni quali
onclick
.
Rappresentazione JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Campi | |
---|---|
topLabel
|
Il testo dell'etichetta in alto. Testo formattato supportato. Per ulteriori informazioni sulla formattazione del testo, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace. |
content
|
Il testo dei contenuti. Testo formattato supportato e sempre obbligatorio. Per ulteriori informazioni sulla formattazione del testo, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace. |
contentMultiline
|
Se i contenuti devono essere su più righe. |
bottomLabel
|
Il testo dell'etichetta in basso. Testo formattato supportato. Per ulteriori informazioni sulla formattazione del testo, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace. |
onClick
|
La
|
Campo unione
icons . Almeno una delle icone,
top_label
e
bottom_label
è necessario definire.
icons
può essere solo uno dei seguenti:
|
|
icon
|
Un valore enum sostituito dall'API Chat con l'immagine dell'icona corrispondente. |
iconUrl
|
L'icona specificata da un URL. |
Campo unione
control . Un widget di controllo. Puoi impostare
button
o
switch_widget , ma non entrambe.
control
può essere solo uno dei seguenti:
|
|
button
|
Un pulsante su cui è possibile fare clic per attivare un'azione. |
Icona
L'insieme di icone supportate.
Enum | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
Pulsante
Un pulsante. Può essere un pulsante di testo o un pulsante immagine.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
textButton
|
Un pulsante con testo e
|
imageButton
|
Un pulsante con immagine e
|
TextButton
Un pulsante con testo e
onclick
un'azione.
Rappresentazione JSON |
---|
{
"text": string,
"onClick": {
object (
|
Campi | |
---|---|
text
|
Il testo del pulsante. |
onClick
|
La
|
ImageButton
Un pulsante immagine con
onclick
un'azione.
Rappresentazione JSON |
---|
{ "onClick": { object ( |
Campi | |
---|---|
onClick
|
La
|
name
|
Il nome di questo
|
Campo unione
icons . L'icona può essere specificata tramite un
Icon
enum
o un URL.
icons
può essere solo uno dei seguenti:
|
|
icon
|
L'icona specificata da un
|
iconUrl
|
L'icona specificata da un URL. |
CardAction
Un'azione della scheda è l'azione associata alla scheda. Per una scheda fattura, un'azione tipica è: elimina la fattura, invia una fattura via email o apri la fattura nel browser.
Non supportata dalle app Google Chat.
Rappresentazione JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Campi | |
---|---|
actionLabel
|
L'etichetta che veniva visualizzata nella voce del menu azione. |
onClick
|
L'azione YAML per questa attività. |