Scheda
Una scheda è un elemento dell'interfaccia utente che può contenere widget dell'interfaccia utente 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 divisore di riga. |
card
|
Le azioni di questa scheda. |
name
|
Nome della carta. |
CardHeader
Rappresentazione JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum ( |
Campi | |
---|---|
title
|
Il titolo deve essere specificato. 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. |
image
|
Il tipo di immagine (ad esempio bordo quadrato o bordo circolare). |
image
|
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 saperne di più 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 sono
|
Campo unione
data . Un
WidgetMarkup
può avere solo uno dei seguenti elementi. Puoi utilizzare più campi
WidgetMarkup
per visualizzare più elementi.
data
può essere solo uno dei seguenti:
|
|
text
|
Mostra un paragrafo di testo in questo widget. |
image
|
Visualizza un'immagine in questo widget. |
key
|
Mostra un elemento chiave-valore in questo widget. |
TextParagraph
Un paragrafo di testo. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattare il testo nelle app Google Chat e Formattare il 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'azione
onclick
.
Rappresentazione JSON |
---|
{
"imageUrl": string,
"onClick": {
object ( |
Campi | |
---|---|
image
|
L'URL dell'immagine. |
on
|
L'azione
|
aspect
|
Le proporzioni dell'immagine (larghezza e altezza). Questo campo ti consente di riservare l'altezza giusta per l'immagine in attesa del suo caricamento. Non ha lo scopo di sostituire le proporzioni predefinite dell'immagine. Se il criterio non viene configurato, il server lo riempie precaricando l'immagine. |
OnClick
Un'azione onclick
(ad esempio, aprire un link).
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione
|
|
action
|
Un'azione del modulo viene attivata da questa azione
|
open
|
Questa azione
|
FormAction
Un'azione del modulo descrive il comportamento quando viene inviato. Ad esempio, puoi chiamare Apps Script per gestire il modulo.
Rappresentazione JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object ( |
Campi | |
---|---|
action
|
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 nell'ambito 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. Puoi utilizzare action method = snooze()
, per trasmettere 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 alcune azioni come il pulsante onclick
.
Rappresentazione JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Campi | |
---|---|
top
|
Il testo dell'etichetta in alto. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace. |
content
|
Il testo dei contenuti. Testo formattato supportato e sempre obbligatorio. Per saperne di più sulla formattazione del testo, consulta Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace. |
content
|
Se i contenuti devono essere su più righe. |
bottom
|
Il testo dell'etichetta in basso. Testo formattato supportato. Per saperne di più sulla formattazione del testo, consulta Formattare il testo nelle app Google Chat e Formattare il testo nei componenti aggiuntivi di Google Workspace. |
on
|
L'azione
|
Campo unione
icons . È necessario definire almeno una delle icone,
top_label
e
bottom_label .
icons
può essere solo uno dei seguenti:
|
|
icon
|
Un valore enumerato sostituito dall'API Chat con l'immagine dell'icona corrispondente. |
icon
|
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
|
|
text
|
Un pulsante con testo e
|
image
|
Un pulsante con immagine e azione |
TextButton
Un pulsante con testo e azione
onclick
.
Rappresentazione JSON |
---|
{
"text": string,
"onClick": {
object ( |
Campi | |
---|---|
text
|
Il testo del pulsante. |
on
|
L' |
ImageButton
Un pulsante immagine con un'azione onclick
.
Rappresentazione JSON |
---|
{ "onClick": { object ( |
Campi | |
---|---|
on
|
L'azione
|
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
|
icon
|
L'icona specificata da un URL. |
CardAction
Un'azione della scheda è l'azione associata alla scheda. Per una scheda di fattura, un'azione tipica potrebbe essere: eliminare la fattura, inviare la fattura via email o aprire la fattura nel browser.
Non supportata dalle app Google Chat.
Rappresentazione JSON |
---|
{
"actionLabel": string,
"onClick": {
object ( |
Campi | |
---|---|
action
|
In precedenza, l'etichetta veniva visualizzata nell'elemento del menu Azione. |
on
|
L'azione YAML per questa attività. |