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 divisore 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 sono specificati sia un titolo che un sottotitolo, ognuno occupa una riga. Se viene specificato solo il titolo, occupa entrambe le righe. |
subtitle
|
Il sottotitolo dell'intestazione della scheda. |
imageStyle
|
Il tipo di immagine (ad esempio, bordo quadrato o 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 visualizzati (in verticale) nell'ordine specificato. In tutte le piattaforme, le schede hanno una larghezza fissa stretta, quindi al momento non sono necessarie le proprietà layout (ad es. float).
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 il valore di Pulsanti è |
Campo di 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:
|
|
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 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.
Rappresentazione JSON |
---|
{ "text": string } |
Campi | |
---|---|
text
|
|
Immagine
Un'immagine specificata da un URL e che può avere un'azione onclick
.
Rappresentazione JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Campi | |
---|---|
imageUrl
|
L'URL dell'immagine. |
onClick
|
L'azione |
aspectRatio
|
Le proporzioni di questa immagine (larghezza e altezza). Questo campo ti consente di riservare la giusta altezza per l'immagine in attesa del caricamento. Non è pensato per sostituire le proporzioni integrate 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 di unione
|
|
action
|
Un'azione del modulo viene attivata da questa azione |
openLink
|
Questa azione |
FormAction
Un'azione modulo descrive il comportamento quando il modulo 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 la parte del modulo che ha attivato l'invio del modulo. Queste informazioni vengono riportate nuovamente nell'app Chat nell'ambito dell'evento di clic sulla scheda. Puoi utilizzare lo stesso nome del metodo per diversi elementi che attivano un comportamento comune. |
parameters[]
|
Elenco dei parametri di azione. |
ActionParameter
Elenco dei parametri di stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, prendi in considerazione tre pulsanti per posticipare la sveglia: ora, posticipa un giorno, posticipa la settimana successiva. Puoi utilizzare
action method = snooze()
, passando il tipo di posticipazione e il tempo di posticipazione nell'elenco dei parametri di 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, ad esempio il pulsante onclick
.
Rappresentazione JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Campi | |
---|---|
topLabel
|
Il testo dell'etichetta superiore. 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. |
content
|
Il testo dei contenuti. Testo formattato supportato e sempre obbligatorio. 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. |
contentMultiline
|
Se i contenuti devono essere su più righe. |
bottomLabel
|
Il testo dell'etichetta in basso. 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. |
onClick
|
L'azione |
Campo di unione
icons . È necessario definire almeno una delle icone,
top_label
e
bottom_label .
icons può essere solo uno dei seguenti:
|
|
icon
|
Un valore enum che viene sostituito dall'API Chat con l'immagine dell'icona corrispondente. |
iconUrl
|
L'icona specificata da un URL. |
Campo di unione
control . Un widget di controllo. Puoi impostare
button
o
switch_widget , ma non entrambi.
control può essere solo uno dei seguenti:
|
|
button
|
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
Pulsante. Può essere un pulsante di testo o un pulsante immagine.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo di unione
|
|
textButton
|
Un pulsante con testo e
azione
|
imageButton
|
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. |
onClick
|
L'azione
|
ImageButton
Un pulsante immagine con un'azione onclick
.
Rappresentazione JSON |
---|
{ "onClick": { object ( |
Campi | |
---|---|
onClick
|
L'azione |
name
|
Il nome di questo elemento
|
Campo di unione
icons . L'icona può essere specificata da 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 fattura, un'azione tipica è l'eliminazione della fattura, l'invio della fattura via email o l'apertura della fattura nel browser.
Non supportata dalle app Google Chat.
Rappresentazione JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Campi | |
---|---|
actionLabel
|
L'etichetta era visualizzata nella voce del menu azione. |
onClick
|
L'azione di tipo sull'attività. |