Card

Un'interfaccia di scheda visualizzata in un messaggio chat di Google Chat o in un componente aggiuntivo di Google Workspace.

Le schede supportano un layout definito, elementi UI interattivi come i pulsanti e rich media come le immagini. Utilizza le schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli nel passaggio successivo.

Progetta e visualizza l'anteprima delle schede con Card Builder.

Apri Card Builder

Per scoprire come creare le schede, consulta la seguente documentazione:

Nota: puoi aggiungere fino a 100 widget per scheda. Se i widget di una sezione superano il numero totale di 100, l'intera sezione e tutte quelle successive vengono ignorate. Questo limite si applica sia ai messaggi con schede sia alle finestre di dialogo nelle app Google Chat e alle schede nei componenti aggiuntivi di Google Workspace.

Esempio: messaggio con scheda per un'app Google Chat

Esempio di scheda contatto

Per creare il messaggio con scheda di esempio in Google Chat, utilizza il seguente JSON:

{
  "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"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
Rappresentazione JSON 
{
  "header": {
    object (CardHeader)
  },
  "sections": [
    {
      object (Section)
    }
  ],
  "sectionDividerStyle": enum (DividerStyle),
  "cardActions": [
    {
      object (CardAction)
    }
  ],
  "name": string,
  "fixedFooter": {
    object (CardFixedFooter)
  },
  "displayStyle": enum (DisplayStyle),
  "peekCardHeader": {
    object (CardHeader)
  },
  "expressionData": [
    {
      object (ExpressionData)
    }
  ]
}
Campi
header

object (CardHeader)

L'intestazione della scheda. Un'intestazione di solito contiene un'immagine principale e un titolo. Le intestazioni vengono sempre visualizzate nella parte superiore di una scheda.
sections[]

object (Section)

Contiene una raccolta di widget. Ogni sezione ha la propria intestazione facoltativa. Le sezioni sono separate visivamente da una linea di divisione. Per un esempio nelle app di Chat di Google, consulta Definisci una sezione di una scheda.
sectionDividerStyle

enum (DividerStyle)

Lo stile del divisore tra intestazione, sezioni e piè di pagina.
cardActions[]

object (CardAction)

Le azioni della scheda. Le azioni vengono aggiunte al menu della barra degli strumenti della scheda. Supporta fino a 10 elementi CardAction.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.

Ad esempio, il seguente JSON crea un menu Azioni della scheda con le opzioni Settings e Send Feedback:

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]
name

string

Nome della carta. Utilizzato come identificatore della scheda nella navigazione tra le schede.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
displayStyle

enum (DisplayStyle)

Nei componenti aggiuntivi di Google Workspace, imposta le proprietà di visualizzazione di peekCardHeader.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
peekCardHeader

object (CardHeader)

Quando vengono visualizzati contenuti contestuali, l'intestazione della scheda di anteprima funge da segnaposto in modo che l'utente possa spostarsi in avanti tra le schede della home page e le schede contestuali.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
expressionData[]

object (ExpressionData)

I dati dell'espressione per la scheda.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

CardHeader

Rappresenta l'intestazione di una scheda. Per un esempio nelle app di Chat di Google, consulta Aggiungi un'intestazione.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "title": string,
  "subtitle": string,
  "imageType": enum (ImageType),
  "imageUrl": string,
  "imageAltText": string
}
Campi
title

string

Obbligatorio. Il titolo dell'intestazione della scheda. L'intestazione ha un'altezza fissa: se vengono specificati sia un titolo che un sottotitolo, ciascuno occupa una riga. Se viene specificato solo il titolo, questo occupa entrambe le righe.
subtitle

string

Il sottotitolo dell'intestazione della scheda. Se specificato, viene visualizzato su una riga separata sotto title.
imageType

enum (ImageType)

La forma utilizzata per ritagliare l'immagine.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
imageUrl

string

L'URL HTTPS dell'immagine nell'intestazione della scheda.
imageAltText

string

Il testo alternativo di questa immagine utilizzato per l'accessibilità.

Sezione

Una sezione contiene una raccolta di widget che vengono visualizzati verticalmente nell'ordine in cui sono specificati.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer,
  "id": string,
  "collapseControl": {
    object (CollapseControl)
  }
}
Campi
header

string

Testo visualizzato nella parte superiore di una sezione. Supporta testo semplice formattato in HTML. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.
widgets[]

object (Widget)

Tutti i widget della sezione. Deve contenere almeno un widget. Una scheda supporta fino a 100 widget in tutte le sezioni.
collapsible

boolean

Indica se questa sezione è comprimibile.

Le sezioni comprimibili nascondono alcuni o tutti i widget, ma gli utenti possono espandere la sezione per visualizzare i widget nascosti facendo clic su Mostra altro. Gli utenti possono nascondere nuovamente i widget facendo clic su Mostra meno.

Per determinare quali widget sono nascosti, specifica uncollapsibleWidgetsCount.
uncollapsibleWidgetsCount

integer

Il numero di widget non comprimibili che rimangono visibili anche quando una sezione è compressa.

Ad esempio, se una sezione contiene cinque widget e uncollapsibleWidgetsCount è impostato su 2, i primi due widget vengono sempre mostrati e gli ultimi tre sono compressi per impostazione predefinita. uncollapsibleWidgetsCount viene preso in considerazione solo quando collapsible è true.
id

string

Un ID univoco assegnato alla sezione, utilizzato per identificare la sezione da modificare. L'ID ha un limite di caratteri di 64 caratteri e deve essere nel formato [a-zA-Z0-9-]+.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
collapseControl

object (CollapseControl)

Facoltativo. Definisci il pulsante di espansione e compressione della sezione. Questo pulsante viene visualizzato solo se la sezione è comprimibile. Se questo campo non viene impostato, viene utilizzato il pulsante predefinito.

Widget

Ogni scheda è composta da widget.

Un widget è un oggetto composito che può rappresentare testo, immagini, pulsanti e altri tipi di oggetti.

Rappresentazione JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "id": string,
  "visibility": enum (Visibility),
  "eventActions": [
    {
      object (EventAction)
    }
  ],

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "divider": {
    object (Divider)
  },
  "grid": {
    object (Grid)
  },
  "columns": {
    object (Columns)
  },
  "carousel": {
    object (Carousel)
  },
  "chipList": {
    object (ChipList)
  }
}
Campi
horizontalAlignment

enum (HorizontalAlignment)

Specifica se i widget sono allineati a sinistra, a destra o al centro di una colonna.
id

string

Un ID univoco assegnato al widget, utilizzato per identificare il widget da modificare. L'ID ha un limite di caratteri di 64 caratteri e deve essere nel formato [a-zA-Z0-9-]+.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
visibility

enum (Visibility)

Specifica se il widget è visibile o nascosto. Il valore predefinito è VISIBLE.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
eventActions[]

object (EventAction)

Specifica le azioni dell'evento che possono essere eseguite sul widget.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
Un widget può avere solo uno dei seguenti elementi. Puoi utilizzare più campi del widget per visualizzare più elementi. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textParagraph

object (TextParagraph)

Visualizza un paragrafo di testo. Supporta testo semplice formattato in HTML. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

Ad esempio, il seguente JSON crea un testo in grassetto:

"textParagraph": {
  "text": "  <b>bold text</b>"
}
image

object (Image)

Mostra un'immagine.

Ad esempio, il seguente JSON crea un'immagine con testo alternativo:

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}
decoratedText

object (DecoratedText)

Mostra un elemento di testo decorato.

Ad esempio, il seguente JSON crea un widget di testo decorato che mostra l'indirizzo email:

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}
buttonList

object (ButtonList)

Un elenco di pulsanti.

Ad esempio, il seguente JSON crea due pulsanti. Il primo è un pulsante di testo blu e il secondo è un pulsante immagine che apre un link:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

object (TextInput)

Mostra una casella di testo in cui gli utenti possono digitare.

Ad esempio, il seguente JSON crea un input di testo per un indirizzo email:

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

Un altro esempio: il seguente JSON crea un input di testo per un linguaggio di programmazione con suggerimenti statici:

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
selectionInput

object (SelectionInput)

Mostra un controllo di selezione che consente agli utenti di selezionare gli elementi. I controlli di selezione possono essere caselle di controllo, pulsanti di opzione, opzioni o menu a discesa.

Ad esempio, il seguente JSON crea un menu a discesa che consente agli utenti di scegliere una taglia:

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}
dateTimePicker

object (DateTimePicker)

Mostra un widget che consente agli utenti di inserire una data, un'ora o una data e un'ora.

Ad esempio, il seguente JSON crea un selettore di data e ora per pianificare un appuntamento:

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": 796435200000
}
divider

object (Divider)

Visualizza un divisore a linea orizzontale tra i widget.

Ad esempio, il seguente JSON crea un divisore:

"divider": {
}
grid

object (Grid)

Visualizza una griglia con una raccolta di elementi.

Una griglia supporta un numero qualsiasi di colonne ed elementi. Il numero di righe è determinato dai limiti superiori del numero di elementi diviso per il numero di colonne. Una griglia con 10 elementi e 2 colonne ha 5 righe. Una griglia con 11 elementi e 2 colonne ha 6 righe.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, il seguente JSON crea una griglia a due colonne con un singolo elemento:

"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"
    }
  }
}
columns

object (Columns)

Visualizza fino a 2 colonne.

Per includere più di due colonne o per utilizzare le righe, utilizza il widget Grid.

Ad esempio, il seguente JSON crea due colonne, ciascuna contenente paragrafi di testo:

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}
carousel

object (Carousel)

Contiene una raccolta di elementi CarouselCard, ognuno dei quali contiene widget nidificati. Ad esempio, questa è una rappresentazione JSON di un carosello che contiene due schede carosello, ciascuna con un paragrafo di testo:

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in the carousel."
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in the carousel."
          }
        }
      ]
    }
  ]
}
chipList

object (ChipList)

Un elenco di chip.

Ad esempio, il seguente JSON crea due chip. Il primo è un chip di testo e il secondo è un chip con icona che apre un link:

"chipList": {
  "chips": [
    {
      "label": "Edit",
      "disabled": true
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
Fine dei campi che si escludono a vicenda.

TextParagraph

Un paragrafo di testo che supporta la formattazione. Per un esempio nelle app Google Chat, consulta Aggiungi un paragrafo di testo formattato. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "text": string,
  "maxLines": integer,
  "textSyntax": enum (TextSyntax)
}
Campi
text

string

Il testo visualizzato nel widget.
maxLines

integer

Il numero massimo di righe di testo visualizzate nel widget. Se il testo supera il numero massimo di righe specificato, i contenuti in eccesso vengono nascosti dietro un pulsante Mostra altro. Se il testo è uguale o più breve del numero massimo di righe specificato, il pulsante Mostra altro non viene visualizzato.

Il valore predefinito è 0, nel qual caso viene visualizzato tutto il contesto. I valori negativi vengono ignorati.
textSyntax

enum (TextSyntax)

La sintassi del testo. Se non è impostato, il testo viene visualizzato come HTML.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

TextSyntax

Sintassi da utilizzare per la formattazione del testo.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Enum
TEXT_SYNTAX_UNSPECIFIED Se non specificato, il testo viene visualizzato come HTML.
HTML Il testo viene visualizzato come HTML. Questo è il valore predefinito.
MARKDOWN Il testo viene visualizzato come Markdown.

Immagine

Un'immagine specificata da un URL che può avere un'azione onClick. Per un esempio, consulta Aggiungi un'immagine.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "imageUrl": string,
  "onClick": {
    object (OnClick)
  },
  "altText": string
}
Campi
imageUrl

string

L'URL HTTPS che ospita l'immagine.

Ad esempio:

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick

object (OnClick)

Quando un utente fa clic sull'immagine, il clic attiva questa azione.
altText

string

Il testo alternativo di questa immagine utilizzato per l'accessibilità.

DecoratedText

Un widget che mostra il testo con decorazioni facoltative, come un'etichetta sopra o sotto il testo, un'icona davanti al testo, un widget di selezione o un pulsante dopo il testo. Per un esempio nelle app di Chat di Google, consulta Visualizza testo con testo decorativo.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "startIconVerticalAlignment": enum (VerticalAlignment),
  "topLabel": string,
  "topLabelText": {
    object (TextParagraph)
  },
  "text": string,
  "contentText": {
    object (TextParagraph)
  },
  "wrapText": boolean,
  "bottomLabel": string,
  "bottomLabelText": {
    object (TextParagraph)
  },
  "onClick": {
    object (OnClick)
  },

  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
}
Campi
icon
(deprecated)

object (Icon)

Deprecato a favore di startIcon.
startIcon

object (Icon)

L'icona visualizzata davanti al testo.
startIconVerticalAlignment

enum (VerticalAlignment)

Facoltativo. Allineamento verticale dell'icona di avvio. Se non viene impostato, l'icona verrà centrata verticalmente.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
topLabel

string

Il testo visualizzato sopra text. Tronca sempre.
topLabelText

object (TextParagraph)

TextParagraph equivalente di topLabel. Tronca sempre. Consente una formattazione più complessa rispetto a topLabel.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
text

string

Obbligatorio. Il testo principale.

Supporta la formattazione semplice. Per saperne di più sulla formattazione del testo, consulta Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.
contentText

object (TextParagraph)

TextParagraph equivalente di text. Consente una formattazione più complessa rispetto a text.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
wrapText

boolean

L'impostazione del testo a capo. Se true, il testo va a capo e viene visualizzato su più righe. In caso contrario, il testo viene troncato.

Si applica solo a text, non a topLabel e bottomLabel.
bottomLabel

string

Il testo visualizzato sotto text. Va sempre a capo.
bottomLabelText

object (TextParagraph)

TextParagraph equivalente di bottomLabel. Va sempre a capo. Consente una formattazione più complessa rispetto a bottomLabel.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
onClick

object (OnClick)

Questa azione viene attivata quando gli utenti fanno clic in un punto qualsiasi del widget DecoratedText (tra cui text, topLabel, bottomLabel e le icone), ad eccezione di quando fanno clic su un controllo interattivo separato (button o switchControl).
Un pulsante, un'opzione, una casella di controllo o un'immagine che viene visualizzata a destra del testo nel widget decoratedText. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
button

object (Button)

Un pulsante su cui un utente può fare clic per attivare un'azione.
switchControl

object (SwitchControl)

Un widget di tipo switch su cui un utente può fare clic per modificarne lo stato e attivare un'azione.
endIcon

object (Icon)

Un'icona visualizzata dopo il testo.

Supporta icone integrate e personalizzate.
Fine dei campi che si escludono a vicenda.

VerticalAlignment

Rappresenta l'attributo di allineamento verticale.

Enum
VERTICAL_ALIGNMENT_UNSPECIFIED Tipo non specificato. Non utilizzare.
TOP Allineamento alla posizione superiore.
MIDDLE Allineamento alla posizione centrale.
BOTTOM Allineamento alla posizione in basso.

SwitchControl

Un pulsante di attivazione/disattivazione o una casella di controllo all'interno di un widget decoratedText.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Supportato solo nel widget decoratedText.

Rappresentazione JSON 
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
Campi
name

string

Il nome con cui viene identificato il widget di opzione in un evento di input del modulo (come chiave in CommonEventObject.form_inputs).

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
value

string

Il valore restituito in CommonEventObject.form_inputs[name].string_inputs quando l'opzione è selezionata (selected è true). Se selected è true e value non è impostato, in stringInputs.value viene restituita una stringa vuota (""). Quando selected è false, questo valore viene omesso da stringInputs.value.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
selected

boolean

Quando true, l'opzione è selezionata e il relativo value è incluso in CommonEventObject.form_inputs[name].string_inputs.value.
onChangeAction

object (Action)

L'azione da eseguire quando lo stato dell'interruttore viene modificato, ad esempio la funzione da eseguire.
controlType

enum (ControlType)

Aspetto dell'opzione nell'interfaccia utente.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

ControlType

Come appare l'opzione nell'interfaccia utente.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
SWITCH Un interruttore di attivazione/disattivazione.
CHECKBOX Deprecato a favore di CHECK_BOX.
CHECK_BOX Una casella di controllo.

TextInput

Un campo in cui gli utenti possono inserire del testo. Supporta i suggerimenti e le azioni di modifica. Supporta la convalida dell'invio dei moduli. Quando Action.all_widgets_are_required è impostato su true o questo widget è specificato in Action.required_widgets, l'azione di invio viene bloccata a meno che non venga inserito un valore. Per un esempio nelle app Google Chat, consulta Aggiungi un campo in cui un utente può inserire testo.

Le app di Chat ricevono e possono elaborare il valore del testo inserito durante gli eventi di input del modulo. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.

Quando devi raccogliere dati non definiti o astratti dagli utenti, utilizza un campo di immissione di testo. Per raccogliere dati definiti o enumerati dagli utenti, utilizza il widget SelectionInput.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "name": string,
  "label": string,
  "hintText": string,
  "value": string,
  "type": enum (Type),
  "onChangeAction": {
    object (Action)
  },
  "initialSuggestions": {
    object (Suggestions)
  },
  "autoCompleteAction": {
    object (Action)
  },
  "validation": {
    object (Validation)
  },
  "placeholderText": string,

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campi
name

string

Il nome con cui viene identificato l'input di testo in un evento di input del modulo.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
label

string

Il testo visualizzato sopra il campo di immissione testo nell'interfaccia utente.

Specifica il testo che aiuta l'utente a inserire le informazioni richieste dalla tua app. Ad esempio, se chiedi il nome di una persona, ma hai bisogno specificamente del suo cognome, scrivi surname anziché name.

Obbligatorio se hintText non è specificato. Altrimenti, facoltativo.
hintText

string

Testo visualizzato sotto il campo di immissione del testo per aiutare gli utenti invitandoli a inserire un determinato valore. Questo testo è sempre visibile.

Obbligatorio se label non è specificato. Altrimenti, facoltativo.
value

string

Il valore inserito da un utente, restituito nell'ambito di un evento di input del modulo.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.
type

enum (Type)

Come appare un campo di immissione testo nell'interfaccia utente. Ad esempio, se il campo è a riga singola o su più righe.
onChangeAction

object (Action)

Cosa fare quando si verifica una modifica nel campo di immissione del testo. Ad esempio, un utente che aggiunge o elimina testo nel campo.

Esempi di azioni da intraprendere includono l'esecuzione di una funzione personalizzata o l'apertura di una finestra di dialogo in Google Chat.
initialSuggestions

object (Suggestions)

Valori suggeriti che gli utenti possono inserire. Questi valori vengono visualizzati quando gli utenti fanno clic all'interno del campo di immissione di testo. Man mano che gli utenti digitano, i valori suggeriti vengono filtrati dinamicamente in modo da corrispondere a ciò che hanno digitato.

Ad esempio, un campo di immissione di testo per il linguaggio di programmazione potrebbe suggerire Java, JavaScript, Python e C++. Quando gli utenti iniziano a digitare Jav, l'elenco dei suggerimenti viene filtrato per mostrare solo Java e JavaScript.

I valori suggeriti aiutano gli utenti a inserire valori comprensibili per l'app. Quando fanno riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Suggerire JavaScript può standardizzare il modo in cui gli utenti interagiscono con la tua app.

Se specificato, TextInput.type è sempre SINGLE_LINE, anche se è impostato su MULTIPLE_LINE.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
autoCompleteAction

object (Action)

Facoltativo. Specifica l'azione da intraprendere quando il campo di immissione di testo fornisce suggerimenti agli utenti che interagiscono con il campo.

Se non specificato, i suggerimenti vengono impostati da initialSuggestions ed elaborati dal client.

Se specificato, l'app esegue l'azione specificata qui, ad esempio l'esecuzione di una funzione personalizzata.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
validation

object (Validation)

Specifica la convalida del formato di input necessaria per questo campo di testo.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
placeholderText

string

Testo visualizzato nel campo di immissione del testo quando il campo è vuoto. Utilizza questo testo per chiedere agli utenti di inserire un valore. Ad esempio, Enter a number from 0 to 100.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
hostAppDataSource

object (HostAppDataSourceMarkup)

Un'origine dati univoca per un'applicazione in hosting di Google Workspace, ad esempio email di Gmail, eventi di Google Calendar o messaggi chat di Google Chat.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
Fine dei campi che si escludono a vicenda.

Tipo

Aspetto di un campo di immissione testo nell'interfaccia utente. Ad esempio, se si tratta di un campo di immissione a riga singola o di un input su più righe. Se initialSuggestions è specificato, type è sempre SINGLE_LINE, anche se è impostato su MULTIPLE_LINE.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
SINGLE_LINE Il campo di immissione di testo ha un'altezza fissa di una riga.
MULTIPLE_LINE Il campo di immissione di testo ha un'altezza fissa di più righe.

RenderActions

Un insieme di istruzioni di rendering che indica a una scheda di eseguire un'azione o all'app host del componente aggiuntivo o all'app di Chat di eseguire un'azione specifica dell'app.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Campi
action

Action

Azione

Campi
navigations[]

Navigation

Esegue il push, il pop o l'aggiornamento di una scheda.

Componenti aggiuntivi in Google Chat.

Aggiungi una nuova scheda allo stack (naviga in avanti). Per le app di Chat, disponibile solo per la home dell'app.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

navigations: {
  pushCard: CARD
}

Sostituisci la carta in cima con una nuova carta. Per le app di Chat, disponibile solo per la home dell'app.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

navigations: {
  updateCard: CARD
}

Suggerimenti

Valori suggeriti che gli utenti possono inserire. Questi valori vengono visualizzati quando gli utenti fanno clic all'interno del campo di immissione di testo. Man mano che gli utenti digitano, i valori suggeriti vengono filtrati dinamicamente in base a ciò che hanno digitato.

Ad esempio, un campo di immissione di testo per il linguaggio di programmazione potrebbe suggerire Java, JavaScript, Python e C++. Quando gli utenti iniziano a digitare Jav, l'elenco dei suggerimenti viene filtrato per mostrare Java e JavaScript.

I valori suggeriti aiutano gli utenti a inserire valori comprensibili per l'app. Quando fanno riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Suggerire JavaScript può standardizzare il modo in cui gli utenti interagiscono con la tua app.

Se specificato, TextInput.type è sempre SINGLE_LINE, anche se è impostato su MULTIPLE_LINE.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "items": [
    {
      object (SuggestionItem)
    }
  ]
}
Campi
items[]

object (SuggestionItem)

Un elenco di suggerimenti utilizzati per i consigli di completamento automatico nei campi di immissione di testo.

SuggestionItem

Un valore suggerito che gli utenti possono inserire in un campo di immissione di testo.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{

  "text": string
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
text

string

Il valore di un input suggerito per un campo di immissione di testo. Questo equivale a ciò che gli utenti inseriscono autonomamente.
Fine dei campi che si escludono a vicenda.

Convalida

Rappresenta i dati necessari per convalidare il widget a cui è collegato.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "characterLimit": integer,
  "inputType": enum (InputType)
}
Campi
characterLimit

integer

Specifica il limite di caratteri per i widget di immissione di testo. Tieni presente che questo viene utilizzato solo per l'input di testo e viene ignorato per altri widget.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
inputType

enum (InputType)

Specifica il tipo di widget di input.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

InputType

Il tipo di widget di input.

Enum
INPUT_TYPE_UNSPECIFIED Tipo non specificato. Non utilizzare.
TEXT Testo normale che accetta tutti i caratteri.
INTEGER Un valore intero.
FLOAT Un valore in virgola mobile.
EMAIL Un indirizzo email.
EMOJI_PICKER Un'emoji selezionata dal selettore di emoji fornito dal sistema.

HostAppDataSourceMarkup

Un'origine dati di un'applicazione Google Workspace. L'origine dati compila gli elementi disponibili per un widget.

Rappresentazione JSON 
{

  "chatDataSource": {
    object (ChatClientDataSourceMarkup)
  },
  "workflowDataSource": {
    object (WorkflowDataSourceMarkup)
  }
}
Campi
L'applicazione Google Workspace che compila gli elementi disponibili per un widget. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
chatDataSource

object (ChatClientDataSourceMarkup)

Un'origine dati di Google Chat.
workflowDataSource

object (WorkflowDataSourceMarkup)

Un'origine dati di Google Workflows.
Fine dei campi che si escludono a vicenda.

ChatClientDataSourceMarkup

Per un widget SelectionInput che utilizza un menu a selezione multipla, un'origine dati di Google Chat. L'origine dati compila gli elementi di selezione per il menu di selezione multipla. Ad esempio, un utente può selezionare gli spazi di Google Chat di cui è membro.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{

  "spaceDataSource": {
    object (SpaceDataSource)
  }
}
Campi
L'origine dati di Google Chat. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
spaceDataSource

object (SpaceDataSource)

Spazi di Google Chat di cui l'utente è membro.
Fine dei campi che si escludono a vicenda.

SpaceDataSource

Un'origine dati che compila gli spazi di Google Chat come elementi di selezione per un menu a selezione multipla. Compila solo gli spazi di cui l'utente è membro.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "defaultToCurrentSpace": boolean
}
Campi
defaultToCurrentSpace

boolean

Se impostato su true, il menu di selezione multipla seleziona lo spazio di Google Chat corrente come elemento per impostazione predefinita.

WorkflowDataSourceMarkup

* Supportato solo dal flusso di lavoro di Google Workspace, ma non dalle app Google Chat o dai componenti aggiuntivi di Google Workspace.

In un widget TextInput o SelectionInput con tipo MULTI_SELECT o DateTimePicker, fornisci l'origine dati di Google.

Rappresentazione JSON 
{
  "includeVariables": boolean,
  "type": enum (Type)
}
Campi
includeVariables

boolean

Se includere o meno le variabili del passaggio precedente nell'origine dati.
type

enum (Type)

Il tipo di origine dati.

Tipo

Un enum che rappresenta il tipo di origine dati del workflow.

Enum
UNKNOWN Valore predefinito. Non utilizzare.
USER Utenti di Google Workspace. L'utente può visualizzare e selezionare solo gli utenti della sua organizzazione Google Workspace.
SPACE Spazi di Google Chat di cui l'utente è membro.
USER_WITH_FREE_FORM Gli utenti possono scegliere di visualizzare e selezionare i membri esistenti della loro organizzazione Google Workspace o inserire manualmente un indirizzo email o un dominio valido.

SelectionInput

Un widget che crea uno o più elementi della UI che gli utenti possono selezionare. Supporta la convalida dell'invio dei moduli solo per i menu dropdown e multiselect. Quando Action.all_widgets_are_required è impostato su true o questo widget è specificato in Action.required_widgets, l'azione di invio viene bloccata a meno che non venga selezionato un valore. Ad esempio, un menu a discesa o caselle di controllo. Puoi utilizzare questo widget per raccogliere dati che possono essere previsti o enumerati. Per un esempio nelle app di Chat di Google, consulta Aggiungi elementi UI selezionabili.

Le app di Chat possono elaborare il valore degli elementi selezionati o inseriti dagli utenti. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.

Per raccogliere dati non definiti o astratti dagli utenti, utilizza il widget TextInput.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "name": string,
  "label": string,
  "type": enum (SelectionType),
  "items": [
    {
      object (SelectionItem)
    }
  ],
  "onChangeAction": {
    object (Action)
  },
  "multiSelectMinQueryLength": integer,
  "dataSourceConfigs": [
    {
      object (DataSourceConfig)
    }
  ],
  "multiSelectMaxSelectedItems": integer,
  "hintText": string,

  "externalDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
}
Campi
name

string

Obbligatorio. Il nome che identifica l'input di selezione in un evento di input del modulo.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
label

string

Il testo visualizzato sopra il campo di immissione della selezione nell'interfaccia utente.

Specifica il testo che aiuta l'utente a inserire le informazioni richieste dalla tua app. Ad esempio, se gli utenti selezionano l'urgenza di un ticket di lavoro da un menu a discesa, l'etichetta potrebbe essere "Urgenza" o "Seleziona urgenza".
type

enum (SelectionType)

Il tipo di elementi mostrati agli utenti in un widget SelectionInput. I tipi di selezione supportano diversi tipi di interazioni. Ad esempio, gli utenti possono selezionare una o più caselle di controllo, ma possono selezionare un solo valore da un menu a discesa.
items[]

object (SelectionItem)

Un array di elementi selezionabili. Ad esempio, un array di pulsanti di opzione o caselle di controllo. Supporta fino a 100 elementi.
onChangeAction

object (Action)

Se specificato, il modulo viene inviato quando la selezione cambia. Se non viene specificato, devi specificare un pulsante separato che invia il modulo.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
multiSelectMinQueryLength

integer

Per i menu a selezione multipla, il numero di caratteri di testo inseriti da un utente prima che il menu restituisca gli elementi di selezione suggeriti.

Se non viene impostato, il menu a selezione multipla utilizza i seguenti valori predefiniti:

  • Se il menu utilizza un array statico di SelectionInput elementi, il valore predefinito è 0 caratteri e gli elementi dell'array vengono compilati immediatamente.
  • Se il menu utilizza un'origine dati dinamica (multi_select_data_source), per impostazione predefinita vengono richiesti 3 caratteri prima di eseguire una query sull'origine dati per restituire gli elementi suggeriti.
dataSourceConfigs[]

object (DataSourceConfig)

Facoltativo. Le configurazioni dell'origine dati per il controllo di selezione. Questo campo fornisce un controllo più granulare sull'origine dati.

Se specificato, i campi multiSelectMaxSelectedItems, multiSelectMinQueryLength, externalDataSource e platformDataSource vengono ignorati.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio.

Disponibile per Dropdown widget nelle app di Chat di Google Chat. Per il widget Dropdown nelle app Google Chat, è supportato un solo DataSourceConfig. Se vengono impostati più DataSourceConfig, viene utilizzato solo il primo.
multiSelectMaxSelectedItems

integer

Per i menu a selezione multipla, il numero massimo di elementi che un utente può selezionare. Il valore minimo è 1 elemento. Se non specificato, il valore predefinito è 3 elementi.
hintText

string

Facoltativo. Testo visualizzato sotto il campo di immissione della selezione, destinato ad aiutare gli utenti invitandoli a inserire un determinato valore. Questo testo è sempre visibile.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Per un menu a selezione multipla, un'origine dati che compila dinamicamente gli elementi di selezione.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
externalDataSource

object (Action)

Un'origine dati esterna, ad esempio un database relazionale.
platformDataSource

object (PlatformDataSource)

Un'origine dati di Google Workspace.
Fine dei campi che si escludono a vicenda.

SelectionType

Il formato degli elementi che gli utenti possono selezionare. Le diverse opzioni supportano diversi tipi di interazioni. Ad esempio, gli utenti possono selezionare più caselle di controllo, ma possono selezionare un solo elemento da un menu a discesa.

Ogni input di selezione supporta un tipo di selezione. Ad esempio, non è supportata la combinazione di caselle di controllo e opzioni di attivazione/disattivazione.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
CHECK_BOX Un insieme di caselle di controllo. Gli utenti possono selezionare una o più caselle di controllo.
RADIO_BUTTON Un insieme di pulsanti di opzione. Gli utenti possono selezionare un pulsante di opzione.
SWITCH Un set di sensori. Gli utenti possono attivare uno o più sensori.
DROPDOWN

Un menu a discesa. Gli utenti possono selezionare un elemento dal menu.

Per le app di Chat per Google Chat, puoi compilare gli elementi utilizzando un'origine dati dinamica e suggerire automaticamente gli elementi mentre gli utenti digitano nel menu. Ad esempio, gli utenti possono iniziare a digitare il nome di uno spazio di Google Chat e il widget suggerisce automaticamente lo spazio. Per compilare dinamicamente gli elementi di un menu a discesa, utilizza uno dei seguenti tipi di origini dati:

  • Dati di Google Workspace: gli elementi vengono compilati utilizzando i dati di Google Workspace, ad esempio gli utenti di Google Workspace o gli spazi di Google Chat.
  • Dati esterni: gli elementi vengono compilati da un'origine dati esterna a Google Workspace.

Per esempi di come implementare i menu a discesa per le app di Chat, consulta Aggiungi un menu a discesa e Compila dinamicamente i menu a discesa.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.
MULTI_SELECT

Un menu con una casella di testo. Gli utenti possono digitare e selezionare uno o più elementi. Per i componenti aggiuntivi di Google Workspace, devi compilare gli elementi utilizzando un array statico di oggetti SelectionItem.

Per le app Google Chat, puoi anche compilare gli elementi utilizzando un'origine dati dinamica e suggerire automaticamente gli elementi mentre gli utenti digitano nel menu. Ad esempio, gli utenti possono iniziare a digitare il nome di uno spazio di Google Chat e il widget suggerisce automaticamente lo spazio. Per compilare dinamicamente gli elementi di un menu a selezione multipla, utilizza uno dei seguenti tipi di origini dati:

  • Dati di Google Workspace: gli elementi vengono compilati utilizzando i dati di Google Workspace, ad esempio gli utenti di Google Workspace o gli spazi di Google Chat.
  • Dati esterni: gli elementi vengono compilati da un'origine dati esterna a Google Workspace.

Per esempi di come implementare i menu a selezione multipla per le app di Chat, vedi Aggiungi un menu a selezione multipla.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

PlatformDataSource

Per un widget SelectionInput che utilizza un menu a selezione multipla, un'origine dati di Google Workspace. Utilizzato per compilare gli elementi in un menu a selezione multipla.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{

  "commonDataSource": enum (CommonDataSource),
  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campi
L'origine dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
commonDataSource

enum (CommonDataSource)

Un'origine dati condivisa da tutte le applicazioni Google Workspace, ad esempio gli utenti di un'organizzazione Google Workspace.
hostAppDataSource

object (HostAppDataSourceMarkup)

Un'origine dati univoca per un'applicazione host di Google Workspace, ad esempio gli spazi in Google Chat.

Questo campo supporta le librerie client delle API di Google, ma non è disponibile nelle librerie client di Cloud. Per saperne di più, consulta Installa le librerie client.
Fine dei campi che si escludono a vicenda.

CommonDataSource

Un'origine dati condivisa da tutte le applicazioni Google Workspace.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Enum
UNKNOWN Valore predefinito. Non utilizzare.
USER Utenti di Google Workspace. L'utente può visualizzare e selezionare solo gli utenti della sua organizzazione Google Workspace.

DataSourceConfig

Un oggetto di configurazione che consente di configurare le origini dati per un widget.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio.

Rappresentazione JSON 
{

  "remoteDataSource": {
    object (Action)
  },
  "platformDataSource": {
    object (PlatformDataSource)
  }
  "minCharactersTrigger": integer
}
Campi
L'origine dati. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
remoteDataSource

object (Action)

I dati provengono da un fornitore di dati remoto.
platformDataSource

object (PlatformDataSource)

I dati provengono da un'applicazione Google Workspace.
Fine dei campi che si escludono a vicenda.
minCharactersTrigger

integer

Il numero minimo di caratteri che l'utente deve inserire prima che questo fornitore di dati venga attivato (ovvero prima che inizi a restituire risultati).

DateTimePicker

Consente agli utenti di inserire una data, un'ora o entrambe. Supporta la convalida dell'invio dei moduli. Quando Action.all_widgets_are_required è impostato su true o questo widget è specificato in Action.required_widgets, l'azione di invio viene bloccata a meno che non venga selezionato un valore. Per un esempio nelle app Google Chat, consulta Consenti a un utente di scegliere una data e un'ora.

Gli utenti possono inserire testo o utilizzare il selettore per selezionare date e ore. Se gli utenti inseriscono una data o un'ora non valida, il selettore mostra un errore che li invita a inserire le informazioni correttamente.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "name": string,
  "label": string,
  "type": enum (DateTimePickerType),
  "valueMsEpoch": string,
  "timezoneOffsetDate": integer,
  "onChangeAction": {
    object (Action)
  },

  "hostAppDataSource": {
    object (HostAppDataSourceMarkup)
  }
}
Campi
name

string

Il nome con cui viene identificato DateTimePicker in un evento di input del modulo.

Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevi i dati dei moduli.
label

string

Il testo che invita gli utenti a inserire una data, un'ora o una data e un'ora. Ad esempio, se gli utenti stanno fissando un appuntamento, utilizza un'etichetta come Appointment date o Appointment date and time.
type

enum (DateTimePickerType)

Indica se il widget supporta l'inserimento di una data, di un'ora o di una data e un'ora.
valueMsEpoch

string (int64 format)

Il valore predefinito visualizzato nel widget, in millisecondi dall'epoca di Unix.

Specifica il valore in base al tipo di selettore (DateTimePickerType):

  • DATE_AND_TIME: una data e un'ora di calendario in UTC. Ad esempio, per rappresentare il 1° gennaio 2023 alle 12:00 UTC, utilizza 1672574400000.
  • DATE_ONLY: una data di calendario alle ore 00:00:00 UTC. Ad esempio, per rappresentare il 1° gennaio 2023, utilizza 1672531200000.
  • TIME_ONLY: un'ora in formato UTC. Ad esempio, per rappresentare le 12:00, utilizza 43200000 (o 12 * 60 * 60 * 1000).
timezoneOffsetDate

integer

Il numero che rappresenta l'offset del fuso orario rispetto all'ora UTC, in minuti. Se impostato, valueMsEpoch viene visualizzato nel fuso orario specificato. Se non viene impostato, il valore predefinito è l'impostazione del fuso orario dell'utente.

Nota: questo campo è espresso in minuti, mentre i payload degli eventi di interazione dell'utente in genere forniscono i fusi orari in millisecondi (dividi per 60000 per eseguire la conversione).
onChangeAction

object (Action)

Si attiva quando l'utente fa clic su Salva o Cancella nell'interfaccia DateTimePicker.
L'origine dati specificata per rappresentare una data e un'ora. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
hostAppDataSource

object (HostAppDataSourceMarkup)

Un'origine dati univoca per un'applicazione in hosting di Google Workspace, ad esempio email di Gmail, eventi di Google Calendar o messaggi chat di Google Chat.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.
Fine dei campi che si escludono a vicenda.

DateTimePickerType

Il formato della data e dell'ora nel widget DateTimePicker. Determina se gli utenti possono inserire una data, un'ora o entrambe.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
DATE_AND_TIME Gli utenti inseriscono una data e un'ora.
DATE_ONLY Gli utenti inseriscono una data.
TIME_ONLY Gli utenti inseriscono un'ora.

Divisore

Questo tipo non ha campi.

Visualizza un divisore tra i widget sotto forma di linea orizzontale. Per un esempio nelle app Google Chat, consulta Aggiungi un divisore orizzontale tra i widget.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, il seguente JSON crea un divisore:

"divider": {}

Griglia

Visualizza una griglia con una raccolta di elementi. Gli elementi possono includere solo testo o immagini. Per le colonne adattabili o per includere elementi diversi da testo o immagini, utilizza Columns. Per un esempio nelle app di Chat di Google, consulta Visualizza una griglia con una raccolta di elementi.

Una griglia supporta un numero qualsiasi di colonne ed elementi. Il numero di righe è determinato dagli elementi divisi per le colonne. Una griglia con 10 elementi e 2 colonne ha 5 righe. Una griglia con 11 elementi e 2 colonne ha 6 righe.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, il seguente JSON crea una griglia a due colonne con un singolo elemento:

"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"
    }
  }
}
Rappresentazione JSON 
{
  "title": string,
  "items": [
    {
      object (GridItem)
    }
  ],
  "borderStyle": {
    object (BorderStyle)
  },
  "columnCount": integer,
  "onClick": {
    object (OnClick)
  }
}
Campi
title

string

Il testo visualizzato nell'intestazione della griglia.
items[]

object (GridItem)

Gli elementi da visualizzare nella griglia.
borderStyle

object (BorderStyle)

Lo stile del bordo da applicare a ogni elemento della griglia.
columnCount

integer

Il numero di colonne da visualizzare nella griglia. Se questo campo non viene specificato, viene utilizzato un valore predefinito, che varia a seconda di dove viene mostrata la griglia (finestra di dialogo o companion).
onClick

object (OnClick)

Questo callback viene riutilizzato da ogni singolo elemento della griglia, ma con l'identificatore dell'elemento aggiunto ai parametri del callback (nella chiave "grid_item_identifier").

GridItem

Rappresenta un elemento in un layout a griglia. Gli elementi possono contenere testo, un'immagine o entrambi.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "id": string,
  "image": {
    object (ImageComponent)
  },
  "title": string,
  "subtitle": string,
  "layout": enum (GridItemLayout)
}
Campi
id

string

Un identificatore specificato dall'utente per questo elemento della griglia. Questo identificatore viene restituito nei parametri di callback onClick della griglia principale.
image

object (ImageComponent)

L'immagine visualizzata nell'elemento della griglia.
title

string

Il titolo dell'elemento della griglia.
subtitle

string

Il sottotitolo dell'elemento della griglia.
layout

enum (GridItemLayout)

Il layout da utilizzare per l'elemento della griglia.

ImageComponent

Rappresenta un'immagine.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "imageUri": string,
  "altText": string,
  "cropStyle": {
    object (ImageCropStyle)
  },
  "borderStyle": {
    object (BorderStyle)
  }
}
Campi
imageUri

string

L'URL dell'immagine.
altText

string

L'etichetta di accessibilità per l'immagine.
cropStyle

object (ImageCropStyle)

Lo stile di ritaglio da applicare all'immagine.
borderStyle

object (BorderStyle)

Lo stile del bordo da applicare all'immagine.

ImageCropStyle

Rappresenta lo stile di ritaglio applicato a un'immagine.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, ecco come applicare le proporzioni 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}
Rappresentazione JSON 
{
  "type": enum (ImageCropType),
  "aspectRatio": number
}
Campi
type

enum (ImageCropType)

Il tipo di coltura.
aspectRatio

number

Le proporzioni da utilizzare se il tipo di ritaglio è RECTANGLE_CUSTOM.

Ad esempio, ecco come applicare le proporzioni 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

ImageCropType

Rappresenta lo stile di ritaglio applicato a un'immagine.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
IMAGE_CROP_TYPE_UNSPECIFIED Non utilizzare. Non specificato.
SQUARE Valore predefinito. Applica un ritaglio quadrato.
CIRCLE Applica un ritaglio circolare.
RECTANGLE_CUSTOM Applica un ritaglio rettangolare con proporzioni personalizzate. Imposta le proporzioni personalizzate con aspectRatio.
RECTANGLE_4_3 Applica un ritaglio rettangolare con proporzioni 4:3.

BorderStyle

Le opzioni di stile per il bordo di una scheda o di un widget, inclusi il tipo e il colore del bordo.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "type": enum (BorderType),
  "strokeColor": {
    object (Color)
  },
  "cornerRadius": integer
}
Campi
type

enum (BorderType)

Il tipo di bordo.
strokeColor

object (Color)

I colori da utilizzare quando il tipo è BORDER_TYPE_STROKE.

Per impostare il colore del tratto, specifica un valore per i campi red, green e blue. Il valore deve essere un numero in virgola mobile compreso tra 0 e 1 in base al valore del colore RGB, dove 0 (0/255) rappresenta l'assenza di colore e 1 (255/255) rappresenta l'intensità massima del colore.

Ad esempio, il seguente codice imposta il colore su rosso alla massima intensità:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

Il campo alpha non è disponibile per il colore del tratto. Se specificato, questo campo viene ignorato.
cornerRadius

integer

Il raggio dell'angolo del bordo.

BorderType

Rappresenta i tipi di bordo applicati ai widget.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
BORDER_TYPE_UNSPECIFIED Non utilizzare. Non specificato.
NO_BORDER Nessun bordo.
STROKE Valore predefinito. Outline.

GridItemLayout

Rappresenta le varie opzioni di layout disponibili per un elemento della griglia.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
GRID_ITEM_LAYOUT_UNSPECIFIED Non utilizzare. Non specificato.
TEXT_BELOW Il titolo e il sottotitolo vengono visualizzati sotto l'immagine dell'elemento della griglia.
TEXT_ABOVE Il titolo e il sottotitolo vengono visualizzati sopra l'immagine dell'elemento della griglia.

Colonne

Il widget Columns visualizza fino a due colonne in una scheda o in una finestra di dialogo. Puoi aggiungere widget a ogni colonna. I widget vengono visualizzati nell'ordine in cui sono specificati. Per un esempio nelle app Google Chat, consulta Visualizza schede e finestre di dialogo in colonne.

L'altezza di ogni colonna è determinata dalla colonna più alta. Ad esempio, se la prima colonna è più alta della seconda, entrambe le colonne avranno l'altezza della prima colonna. Poiché ogni colonna può contenere un numero diverso di widget, non puoi definire righe o allineare i widget tra le colonne.

Le colonne vengono visualizzate una accanto all'altra. Puoi personalizzare la larghezza di ogni colonna utilizzando il campo HorizontalSizeStyle. Se la larghezza dello schermo dell'utente è troppo ridotta, la seconda colonna viene spostata sotto la prima:

  • Sul web, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 480 pixel.
  • Sui dispositivi iOS, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 300 pt.
  • Sui dispositivi Android, la seconda colonna va a capo se la larghezza dello schermo è inferiore o uguale a 320 dp.

Per includere più di due colonne o per utilizzare le righe, utilizza il widget Grid.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace. Le UI dei componenti aggiuntivi che supportano le colonne includono:

  • La finestra di dialogo visualizzata quando gli utenti aprono il componente aggiuntivo da una bozza di email.
  • La finestra di dialogo visualizzata quando gli utenti aprono il componente aggiuntivo dal menu Aggiungi allegato in un evento di Google Calendar.
Rappresentazione JSON 
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
Campi
columnItems[]

object (Column)

Un array di colonne. Puoi includere fino a due colonne in una scheda o in una finestra di dialogo.

Colonna

Una colonna.

Componenti aggiuntivi di Google Workspace e app di Chat

Rappresentazione JSON 
{
  "horizontalSizeStyle": enum (HorizontalSizeStyle),
  "horizontalAlignment": enum (HorizontalAlignment),
  "verticalAlignment": enum (VerticalAlignment),
  "widgets": [
    {
      object (Widgets)
    }
  ]
}
Campi
horizontalSizeStyle

enum (HorizontalSizeStyle)

Specifica in che modo una colonna riempie la larghezza della scheda.
horizontalAlignment

enum (HorizontalAlignment)

Specifica se i widget sono allineati a sinistra, a destra o al centro di una colonna.
verticalAlignment

enum (VerticalAlignment)

Specifica se i widget sono allineati in alto, in basso o al centro di una colonna.
widgets[]

object (Widgets)

Un array di widget inclusi in una colonna. I widget vengono visualizzati nell'ordine in cui sono specificati.

HorizontalSizeStyle

Specifica in che modo una colonna riempie la larghezza della scheda. La larghezza di ogni colonna dipende sia da HorizontalSizeStyle sia dalla larghezza dei widget al suo interno.

Componenti aggiuntivi di Google Workspace e app di Chat

Enum
HORIZONTAL_SIZE_STYLE_UNSPECIFIED Non utilizzare. Non specificato.
FILL_AVAILABLE_SPACE Valore predefinito. La colonna riempie lo spazio disponibile, fino al 70% della larghezza della scheda. Se entrambe le colonne sono impostate su FILL_AVAILABLE_SPACE, ogni colonna occupa il 50% dello spazio.
FILL_MINIMUM_SPACE La colonna occupa la minor quantità di spazio possibile e non più del 30% della larghezza della scheda.

HorizontalAlignment

Specifica se i widget sono allineati a sinistra, a destra o al centro di una colonna.

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Enum
HORIZONTAL_ALIGNMENT_UNSPECIFIED Non utilizzare. Non specificato.
START Valore predefinito. Allinea i widget alla posizione iniziale della colonna. Per i layout da sinistra a destra, l'allineamento è a sinistra. Per i layout da destra a sinistra, l'allineamento è a destra.
CENTER Allinea i widget al centro della colonna.
END Allinea i widget alla posizione finale della colonna. Per i layout da sinistra a destra, allinea i widget a destra. Per i layout da destra a sinistra, allinea i widget a sinistra.

VerticalAlignment

Specifica se i widget sono allineati in alto, in basso o al centro di una colonna.

Componenti aggiuntivi di Google Workspace e app di Chat

Enum
VERTICAL_ALIGNMENT_UNSPECIFIED Non utilizzare. Non specificato.
CENTER Valore predefinito. Allinea i widget al centro di una colonna.
TOP Allinea i widget alla parte superiore di una colonna.
BOTTOM Allinea i widget alla parte inferiore di una colonna.

Widget

I widget supportati che puoi includere in una colonna.

Componenti aggiuntivi di Google Workspace e app di Chat

Rappresentazione JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "image": {
    object (Image)
  },
  "decoratedText": {
    object (DecoratedText)
  },
  "buttonList": {
    object (ButtonList)
  },
  "textInput": {
    object (TextInput)
  },
  "selectionInput": {
    object (SelectionInput)
  },
  "dateTimePicker": {
    object (DateTimePicker)
  },
  "chipList": {
    object (ChipList)
  }
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textParagraph

object (TextParagraph)

TextParagraph widget.
image

object (Image)

Image widget.
decoratedText

object (DecoratedText)

DecoratedText widget.
buttonList

object (ButtonList)

ButtonList widget.
textInput

object (TextInput)

TextInput widget.
selectionInput

object (SelectionInput)

SelectionInput widget.
dateTimePicker

object (DateTimePicker)

DateTimePicker widget.
chipList

object (ChipList)

ChipList widget.
Fine dei campi che si escludono a vicenda.

ChipList

Un elenco di chip disposti in orizzontale, che possono scorrere in orizzontale o andare a capo nella riga successiva.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "layout": enum (Layout),
  "chips": [
    {
      object (Chip)
    }
  ]
}
Campi
layout

enum (Layout)

Layout a elenco di chip specificato.
chips[]

object (Chip)

Un array di chip.

Layout

Il layout a elenco dei chip.

Enum
LAYOUT_UNSPECIFIED Non utilizzare. Non specificato.
WRAPPED Valore predefinito. L'elenco di chip va a capo se non c'è abbastanza spazio orizzontale.
HORIZONTAL_SCROLLABLE I chip scorrono in orizzontale se non rientrano nello spazio disponibile.

Chip

Un chip di testo, icona o testo e icona su cui gli utenti possono fare clic.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "icon": {
    object (Icon)
  },
  "label": string,
  "onClick": {
    object (OnClick)
  },
  "enabled": boolean,
  "disabled": boolean,
  "altText": string
}
Campi
icon

object (Icon)

L'immagine dell'icona. Se sono impostati sia icon che label, l'icona viene visualizzata prima dell'etichetta.
label

string

Il testo visualizzato all'interno del chip.
onClick

object (OnClick)

Facoltativo. L'azione da eseguire quando un utente fa clic sul chip, ad esempio l'apertura di un link ipertestuale o l'esecuzione di una funzione personalizzata.
enabled
(deprecated)

boolean

Ritirato: utilizza invece disabled.

Indica se il chip è in uno stato attivo e risponde alle azioni dell'utente.
disabled

boolean

Indica se il chip è in uno stato non attivo e ignora le azioni dell'utente. Il valore predefinito è false.
altText

string

Il testo alternativo utilizzato per l'accessibilità.

Imposta un testo descrittivo che consenta agli utenti di sapere cosa fa il chip. Ad esempio, se un chip apre un link ipertestuale, scrivi: "Apre una nuova scheda del browser e indirizza alla documentazione per lo sviluppo di Google Chat all'indirizzo https://developers.google.com/workspace/chat".

CarouselCard

Una scheda che può essere visualizzata come elemento di un carosello. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "widgets": [
    {
      object (NestedWidget)
    }
  ],
  "footerWidgets": [
    {
      object (NestedWidget)
    }
  ]
}
Campi
widgets[]

object (NestedWidget)

Un elenco di widget visualizzati nella scheda del carosello. I widget vengono visualizzati nell'ordine in cui sono specificati.
footerWidgets[]

object (NestedWidget)

Un elenco di widget visualizzati nella parte inferiore della scheda del carosello. I widget vengono visualizzati nell'ordine in cui sono specificati.

NestedWidget

Un elenco di widget che possono essere visualizzati in un layout contenitore, ad esempio un CarouselCard. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{

  "textParagraph": {
    object (TextParagraph)
  },
  "buttonList": {
    object (ButtonList)
  },
  "image": {
    object (Image)
  }
}
Campi
Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
textParagraph

object (TextParagraph)

Un widget di paragrafo di testo.
buttonList

object (ButtonList)

Un widget elenco di pulsanti.
image

object (Image)

Un widget immagine.
Fine dei campi che si escludono a vicenda.

Visibilità

Specifica se un elemento UI è visibile o nascosto.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Enum
VISIBILITY_UNSPECIFIED Visibilità non specificata. Non utilizzare.
VISIBLE L'elemento UI è visibile.
HIDDEN L'elemento UI è nascosto.

EventAction

Rappresenta un'azione che può essere eseguita su un elemento UI.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "actionRuleId": string,
  "postEventTriggers": [
    {
      object (Trigger)
    }
  ],

  "commonWidgetAction": {
    object (CommonWidgetAction)
  }
}
Campi
actionRuleId

string

L'identificatore univoco di ActionRule.
postEventTriggers[]

object (Trigger)

L'elenco degli attivatori che verranno attivati dopo l'esecuzione di EventAction.
L'azione da eseguire. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
commonWidgetAction

object (CommonWidgetAction)

Azione comune del widget.
Fine dei campi che si escludono a vicenda.

Trigger

Rappresenta un trigger.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "actionRuleId": string
}
Campi
actionRuleId

string

L'identificatore univoco di ActionRule.

CommonWidgetAction

Rappresenta un'azione non specifica di un widget.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{

  "updateVisibilityAction": {
    object (UpdateVisibilityAction)
  }
}
Campi
L'azione da eseguire. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
updateVisibilityAction

object (UpdateVisibilityAction)

L'azione per aggiornare la visibilità di un widget.
Fine dei campi che si escludono a vicenda.

UpdateVisibilityAction

Rappresenta un'azione che aggiorna la visibilità di un widget.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "visibility": enum (Visibility)
}
Campi
visibility

enum (Visibility)

La nuova visibilità.

CollapseControl

Rappresentano un controllo di espansione e compressione.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "horizontalAlignment": enum (HorizontalAlignment),
  "expandButton": {
    object (Button)
  },
  "collapseButton": {
    object (Button)
  }
}
Campi
horizontalAlignment

enum (HorizontalAlignment)

L'allineamento orizzontale del pulsante di espansione e compressione.
expandButton

object (Button)

Facoltativo. Definisci un pulsante personalizzabile per espandere la sezione. Devono essere impostati entrambi i campi expandButton e collapseButton. Verrà applicato un solo set di campi. Se questo campo non viene impostato, viene utilizzato il pulsante predefinito.
collapseButton

object (Button)

Facoltativo. Definisci un tasto personalizzabile per comprimere la sezione. Devono essere impostati entrambi i campi expandButton e collapseButton. Verrà applicato un solo set di campi. Se questo campo non viene impostato, viene utilizzato il pulsante predefinito.

DividerStyle

Lo stile del divisore di una scheda. Attualmente utilizzato solo per i divisori tra le sezioni delle schede.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Enum
DIVIDER_STYLE_UNSPECIFIED Non utilizzare. Non specificato.
SOLID_DIVIDER Opzione predefinita. Esegui il rendering di un divisore continuo.
NO_DIVIDER Se impostato, non viene visualizzato alcun divisore. Questo stile rimuove completamente il divisore dal layout. Il risultato è equivalente a non aggiungere alcun divisore.

CardAction

Un'azione della scheda è l'azione associata alla scheda. Ad esempio, una scheda di fattura potrebbe includere azioni come l'eliminazione della fattura, l'invio della fattura via email o l'apertura della fattura in un browser.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.

Rappresentazione JSON 
{
  "actionLabel": string,
  "onClick": {
    object (OnClick)
  }
}
Campi
actionLabel

string

L'etichetta visualizzata come voce del menu Azioni.
onClick

object (OnClick)

L'azione onClick per questa attività.

CardFixedFooter

Un piè di pagina permanente (sticky) che viene visualizzato nella parte inferiore della scheda.

L'impostazione di fixedFooter senza specificare primaryButton o secondaryButton genera un errore.

Per le app di Chat, puoi utilizzare i piè di pagina fissi nelle finestre di dialogo, ma non nei messaggi con schede. Per un esempio nelle app di Chat di Google, consulta Aggiungi un piè di pagina persistente.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "primaryButton": {
    object (Button)
  },
  "secondaryButton": {
    object (Button)
  }
}
Campi
primaryButton

object (Button)

Il pulsante principale del piè di pagina fisso. Il pulsante deve essere un pulsante di testo con testo e colore impostati.
secondaryButton

object (Button)

Il pulsante secondario del piè di pagina fisso. Il pulsante deve essere un pulsante di testo con testo e colore impostati. Se secondaryButton è impostato, devi impostare anche primaryButton.

DisplayStyle

Nei componenti aggiuntivi di Google Workspace, determina il modo in cui viene visualizzata una scheda.

Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.

Enum
DISPLAY_STYLE_UNSPECIFIED Non utilizzare. Non specificato.
PEEK L'intestazione della scheda viene visualizzata nella parte inferiore della barra laterale, coprendo parzialmente la scheda attualmente in cima allo stack. Se fai clic sull'intestazione, la scheda viene visualizzata nel gruppo di schede. Se la scheda non ha un'intestazione, ne viene utilizzata una generata.
REPLACE Valore predefinito. La scheda viene visualizzata sostituendo la visualizzazione della scheda superiore nella pila di schede.

ExpressionData

Rappresenta i dati utilizzati per valutare un'espressione.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "id": string,
  "expression": string,
  "conditions": [
    {
      object (Condition)
    }
  ],
  "eventActions": [
    {
      object (EventAction)
    }
  ]
}
Campi
id

string

L'identificatore univoco di ExpressionData.
expression

string

L'espressione non compilata.
conditions[]

object (Condition)

L'elenco delle condizioni determinate dal risultato della valutazione dell'espressione.
eventActions[]

object (EventAction)

L'elenco delle azioni per cui è possibile utilizzare ExpressionData.

Condizione

Rappresenta una condizione che può essere utilizzata per attivare un'azione.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "actionRuleId": string,

  "expressionDataCondition": {
    object (ExpressionDataCondition)
  }
}
Campi
actionRuleId

string

L'identificatore univoco di ActionRule.
La condizione. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
expressionDataCondition

object (ExpressionDataCondition)

La condizione determinata dai dati dell'espressione.
Fine dei campi che si escludono a vicenda.

ExpressionDataCondition

Rappresenta una condizione valutata utilizzando CEL.

Disponibile per i componenti aggiuntivi di Google Workspace che estendono Google Workspace Studio. Non disponibile per le app di Chat di Google Chat.

Rappresentazione JSON 
{
  "conditionType": enum (ConditionType)
}
Campi
conditionType

enum (ConditionType)

Il tipo di condizione.

ConditionType

Il tipo di condizione.

Enum
CONDITION_TYPE_UNSPECIFIED Tipo di condizione non specificato.
EXPRESSION_EVALUATION_SUCCESS La valutazione dell'espressione è riuscita.
EXPRESSION_EVALUATION_FAILURE La valutazione dell'espressione non è riuscita.