Cards v2

Scheda

L'interfaccia di una scheda visualizzata in un messaggio di Google Chat o in un componente aggiuntivo di Google Workspace.

Le schede supportano un layout definito, elementi interattivi dell'interfaccia utente come i pulsanti e rich media come le immagini. Utilizza le schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e indirizzarli verso il passaggio successivo.

Progetta e visualizza l'anteprima delle schede con lo strumento per la creazione di schede.

Apri il generatore di schede

Per scoprire come creare schede, consulta la seguente documentazione:

• Per le app Google Chat, consulta Disegna i componenti di una scheda o di una finestra di dialogo.
• Per i componenti aggiuntivi di Google Workspace, vedi Interfacce basate su schede.

Esempio: messaggio della scheda per un'app Google Chat

Per creare il messaggio della 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": "[e-mail]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "[phone]"
                 }
               },
               {
                 "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) } }

Campi
header	object (CardHeader) L'intestazione della scheda. Un'intestazione di solito contiene un'immagine iniziale 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 un'intestazione facoltativa. Le sezioni sono separate visivamente da una linea divisoria. Per un esempio nelle app Google Chat, vedi Definire una sezione di una scheda.
sectionDividerStyle	enum (DividerStyle) Lo stile del divisore tra l'intestazione, le sezioni e il piè di pagina.
cardActions[]	object (CardAction) Le azioni della scheda. Le azioni vengono aggiunte al menu della barra degli strumenti della scheda. Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat. Ad esempio, il seguente JSON crea un menu di 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 per le app Google Chat.
fixedFooter	object (CardFixedFooter) Il piè di pagina fisso mostrato in fondo a questa scheda. L'impostazione di fixedFooter senza specificare un valore primaryButton o secondaryButton causa un errore. Per le app di chat, puoi utilizzare piè di pagina fissi nelle finestre di dialogo, ma non nei messaggi delle schede. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
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 per consentire all'utente di passare dalle schede della home page alle schede contestuali. Disponibile per i componenti aggiuntivi di Google Workspace e per le app Google Chat.

CardHeader

Rappresenta un'intestazione della scheda. Per un esempio nelle app Google Chat, vedi Aggiungere un'intestazione.

Disponibile per le app 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 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à.

ImageType

La forma utilizzata per ritagliare l'immagine.

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

Enum
SQUARE	Valore predefinito. Applica una maschera quadrata all'immagine. Ad esempio, un'immagine 4x3 diventa 3x3.
CIRCLE	Applica una maschera circolare all'immagine. Ad esempio, un'immagine 4x3 diventa un cerchio con un diametro di 3.

Sezione

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

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

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

Campi
header	string Testo visualizzato nella parte superiore di una sezione. Supporta testo in formato HTML semplice. 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.
widgets[]	object (Widget) Tutti i widget della sezione. Deve contenere almeno un widget.
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 viene compressa. Ad esempio, quando una sezione contiene cinque widget e il valore di uncollapsibleWidgetsCount è impostato su 2, i primi due widget vengono sempre visualizzati e gli ultimi tre sono compressi per impostazione predefinita. Il valore uncollapsibleWidgetsCount viene preso in considerazione solo quando collapsible è equale a true.
collapseControl	object (CollapseControl) (Facoltativo) Definisci il pulsante Espandi e comprimi della sezione. Questo pulsante viene visualizzato solo se la sezione è comprimibile. Se questo campo non è impostato, viene utilizzato il pulsante predefinito. Disponibile per le app Google Chat e per i componenti aggiuntivi di Google Workspace.

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), // Union field data can be only one of the following: "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) }, "chipList": { object (ChipList) } // End of list of possible types for union field data. }

Campi
horizontalAlignment	enum (HorizontalAlignment) Specifica se i widget devono essere allineati a sinistra, a destra o al centro di una colonna.
Campo unione data. Un widget può avere solo uno dei seguenti elementi. Puoi utilizzare più campi del widget per visualizzare più elementi. data può essere solo uno dei seguenti:
textParagraph	object (TextParagraph) Mostra un paragrafo di testo. Supporta il testo semplice con formattazione HTML. 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. Ad esempio, il seguente JSON crea un testo in grassetto: "textParagraph": { "text": " <b>bold text</b>" }
image	object (Image) Consente di visualizzare 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": "[e-mail]", "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" } Come 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 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) Visualizza 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 programmare un appuntamento: "dateTimePicker": { "name": "appointment_time", "label": "Book your appointment at:", "type": "DATE_AND_TIME", "valueMsEpoch": "796435200000" }
divider	object (Divider) Mostra una linea divisoria orizzontale tra i widget. Ad esempio, il seguente JSON crea un divisore: "divider": { }
grid	object (Grid) Mostra una griglia con una raccolta di elementi. Una griglia supporta un numero qualsiasi di colonne ed elementi. Il numero di righe è determinato dal limite superiore 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 Google Chat e i componenti aggiuntivi di Google Workspace. Ad esempio, il seguente JSON crea una griglia di 2 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) Consente di visualizzare fino a due colonne. Per includere più di due colonne o per utilizzare le righe, utilizza il Grid widget. 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" } } ] } ] }
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 di icone che apre un link: "chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] } Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

TextParagraph

Un paragrafo di testo che supporta la formattazione. Per un esempio nelle app Google Chat, consulta Aggiungere un paragrafo di testo formattato. 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.

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

Rappresentazione JSON
{ "text": string, "maxLines": integer }

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 inferiore al numero massimo di righe specificato, non viene visualizzato un pulsante Mostra altro. Il valore predefinito è 0, nel qual caso viene visualizzato tutto il contesto. I valori negativi vengono ignorati. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Immagine

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

Disponibile per le app 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à.

OnClick

Rappresenta la modalità di risposta quando gli utenti fanno clic su un elemento interattivo in una scheda, ad esempio un pulsante.

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

Rappresentazione JSON
{ // Union field data can be only one of the following: "action": { object (Action) }, "openLink": { object (OpenLink) }, "openDynamicLinkAction": { object (Action) }, "card": { object (Card) }, "overflowMenu": { object (OverflowMenu) } // End of list of possible types for union field data. }

Campi
Campo unione data. data può essere solo uno dei seguenti:
action	object (Action) Se specificato, viene attivata un'azione da questo onClick.
openLink	object (OpenLink) Se specificato, onClick attiva un'azione link di apertura.
openDynamicLinkAction	object (Action) Un componente aggiuntivo attiva questa azione quando deve aprire un link. La differenza da openLink precedente è che richiede una comunicazione con il server per ottenere il link. Pertanto, è necessario che il client web esegua alcuni passaggi di preparazione prima di ricevere la risposta all'azione di apertura del link. Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
card	object (Card) Se specificato, dopo il clic viene inviata una nuova scheda alla pila di schede. Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
overflowMenu	object (OverflowMenu) Se specificato, questo onClick apre un menu extra. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Azione

Un'azione che descrive il comportamento quando il modulo viene inviato. Ad esempio, puoi richiamare uno script di Apps Script per gestire il modulo. Se l'azione viene attivata, i valori del modulo vengono inviati al server.

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

Rappresentazione JSON
{ "function": string, "parameters": [ { object (ActionParameter) } ], "loadIndicator": enum (LoadIndicator), "persistValues": boolean, "interaction": enum (Interaction), "requiredWidgets": [ string ], "allWidgetsAreRequired": boolean }

Campi
function	string Una funzione personalizzata da chiamare quando si fa clic sull'elemento contenitore o quando viene attivato in altro modo. Per un esempio di utilizzo, consulta Leggere i dati del modulo.
parameters[]	object (ActionParameter) Elenco dei parametri di azione.
loadIndicator	enum (LoadIndicator) Specifica l'indicatore di caricamento visualizzato durante l'esecuzione dell'azione.
persistValues	boolean Indica se i valori del modulo vengono mantenuti dopo l'azione. Il valore predefinito è false. Se true, i valori del modulo rimangono dopo l'attivazione dell'azione. Per consentire all'utente di apportare modifiche durante l'elaborazione dell'azione, imposta LoadIndicator su NONE. Per i messaggi della scheda nelle app di chat, devi anche impostare il valore ResponseType dell'azione su UPDATE_MESSAGE e utilizzare lo stesso cardId della scheda che conteneva l'azione. Se false, i valori del modulo vengono cancellati quando viene attivata l'azione. Per impedire all'utente di apportare modifiche durante l'elaborazione dell'azione, imposta LoadIndicator su SPINNER.
interaction	enum (Interaction) (Facoltativo) Obbligatorio quando si apre una finestra di dialogo. Cosa fare in risposta a un'interazione con un utente, ad esempio il clic su un pulsante in un messaggio di una scheda. Se non specificato, l'app risponde eseguendo un'action, ad esempio l'apertura di un link o l'esecuzione di una funzione, come di consueto. Se specifichi un interaction, l'app può rispondere in modi interattivi speciali. Ad esempio, impostando interaction su OPEN_DIALOG, l'app può aprire una finestra di dialogo. Se specificato, non viene visualizzato un indicatore di caricamento. Se viene specificato per un componente aggiuntivo, viene eliminata l'intera scheda e non viene visualizzato nulla nel client. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
requiredWidgets[]	string Anteprima per sviluppatori: disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Facoltativo. Compila questo elenco con i nomi dei widget di cui questa azione ha bisogno per un invio valido. Se i widget elencati qui non hanno un valore quando viene invocata questa azione, l'invio del modulo viene interrotto. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
allWidgetsAreRequired	boolean Anteprima per sviluppatori: disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Facoltativo. In questo caso, tutti i widget sono considerati obbligatori per questa azione. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.

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 o Posticipa la settimana successiva. Puoi utilizzare action method = snooze(), per trasmettere il tipo e il tempo di posticipazione nell'elenco dei parametri stringa.

Per scoprire di più, consulta CommonEventObject.

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

Rappresentazione JSON
{ "key": string, "value": string }

Campi
key	string Il nome del parametro per lo script dell'azione.
value	string Il valore del parametro.

LoadIndicator

Specifica l'indicatore di caricamento visualizzato durante l'esecuzione dell'azione.

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

Enum
SPINNER	Viene visualizzata una rotellina che indica il caricamento dei contenuti.
NONE	Non viene visualizzato nulla.

Interazione

(Facoltativo) Obbligatorio quando si apre una finestra di dialogo.

Che cosa fare in risposta a un'interazione con un utente, ad esempio un clic su un pulsante in un messaggio della scheda.

Se non specificato, l'app risponde eseguendo un'action, ad esempio l'apertura di un link o l'esecuzione di una funzione, come di consueto.

Se specifichi un interaction, l'app può rispondere in modi speciali interattivi. Ad esempio, se imposti interaction su OPEN_DIALOG, l'app può aprire una finestra di dialogo.

Se specificato, non viene visualizzato un indicatore di caricamento. Se specificato per un componente aggiuntivo, l'intera scheda viene rimossa e nel client non viene visualizzato nulla.

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

Enum
INTERACTION_UNSPECIFIED	Valore predefinito. Il codice action viene eseguito normalmente.
OPEN_DIALOG	Apre una finestra di dialogo, un'interfaccia basata su schede con finestre che le app di chat utilizzano per interagire con gli utenti. Supportato solo dalle app di Chat in risposta ai clic sui pulsanti dei messaggi della scheda. Se viene specificato per un componente aggiuntivo, viene eliminata l'intera scheda e non viene visualizzato nulla nel client. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

OpenLink

Rappresenta un evento onClick che apre un link ipertestuale.

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

Rappresentazione JSON
{ "url": string, "openAs": enum (OpenAs), "onClose": enum (OnClose) }

Campi
url	string L'URL da aprire.
openAs	enum (OpenAs) Come aprire un link. Disponibile per i componenti aggiuntivi di Google Workspace e non disponibile per le app Google Chat.
onClose	enum (OnClose) Indica se il cliente dimentica un link dopo averlo aperto o lo osserva fino alla chiusura della finestra. Disponibile per i componenti aggiuntivi di Google Workspace e per le app Google Chat.

Apri come

Quando un'azione OnClick apre un link, il client può aprirlo come finestra a grandezza naturale (se si tratta del frame utilizzato dal client) o come overlay (ad esempio un popup). L'implementazione dipende dalle funzionalità della piattaforma client e il valore selezionato potrebbe essere ignorato se il client non lo supporta. FULL_SIZE è supportato da tutti i client.

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

Enum
FULL_SIZE	Il link si apre in una finestra a grandezza originale (se è il frame utilizzato dal cliente).
OVERLAY	Il link si apre come overlay, ad esempio popup.

OnClose

Azione del client quando viene chiuso un link aperto da un'azione OnClick.

L'implementazione dipende dalle funzionalità della piattaforma client. Ad esempio, un browser web potrebbe aprire un link in una finestra popup con un gestore OnClose.

Se sono impostati entrambi i gestori OnOpen e OnClose e la piattaforma client non può supportare entrambi i valori, OnClose ha la precedenza.

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

Enum
NOTHING	Valore predefinito. La carta non viene ricaricata; non succede nulla.
RELOAD	Ricarica la scheda dopo la chiusura della finestra secondaria. Se utilizzata in combinazione con OpenAs.OVERLAY, la finestra secondaria agisce come finestra di dialogo modale e la scheda principale viene bloccata fino alla chiusura della finestra secondaria.

OverflowMenu

Un widget che presenta un menu popup con una o più azioni che gli utenti possono richiamare. Ad esempio, la visualizzazione di azioni non principali in una scheda. Puoi utilizzare questo widget quando le azioni non rientrano nello spazio disponibile. Per utilizzarlo, specifica questo widget nell'azione OnClick dei widget che lo supportano. Ad esempio, in un Button.

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

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

Campi
items[]	object (OverflowMenuItem) Obbligatorio. L'elenco delle opzioni di menu.

OverflowMenuItem

Un'opzione che gli utenti possono richiamare in un menu extra.

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

Rappresentazione JSON
{ "startIcon": { object (Icon) }, "text": string, "onClick": { object (OnClick) }, "disabled": boolean }

Campi
startIcon	object (Icon) L'icona visualizzata davanti al testo.
text	string Obbligatorio. Il testo che identifica o descrive l'elemento per gli utenti.
onClick	object (OnClick) Obbligatorio. L'azione invocata quando viene selezionata un'opzione di menu. Questo OnClick non può contenere un OverflowMenu. Qualsiasi OverflowMenu specificato viene ignorato e l'elemento del menu viene disattivato.
disabled	boolean Indica se l'opzione di menu è disattivata. Il valore predefinito è false.

Icona

Un'icona visualizzata in un widget in una scheda. Per un esempio nelle app Google Chat, consulta Aggiungere un'icona.

Supporta icone integrate e personalizzate.

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

Rappresentazione JSON
{ "altText": string, "imageType": enum (ImageType), // Union field icons can be only one of the following: "knownIcon": string, "iconUrl": string, "materialIcon": { object (MaterialIcon) } // End of list of possible types for union field icons. }

Campi
altText	string (Facoltativo) Una descrizione dell'icona utilizzata per l'accessibilità. Se non specificato, viene fornito il valore predefinito Button. Come best practice, devi impostare una descrizione utile di ciò che viene visualizzato dall'icona e, se applicabile, di ciò che fa. Ad esempio, A user's account portrait o Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat. Se l'icona è impostata in un Button, il altText viene visualizzato come testo di aiuto quando l'utente passa il mouse sopra il pulsante. Tuttavia, se il pulsante imposta anche text, il valore altText dell'icona viene ignorato.
imageType	enum (ImageType) Lo stile di ritaglio applicato all'immagine. In alcuni casi, l'applicazione di un CIRCLE ritaglio fa sì che l'immagine venga disegnata più grande di un'icona integrata.
Campo unione icons. L'icona visualizzata nel widget nella scheda. icons può essere solo uno dei seguenti:
knownIcon	string Mostra una delle icone integrate fornite da Google Workspace. Ad esempio, per visualizzare un'icona a forma di aereo, specifica AIRPLANE. Per gli autobus, specifica BUS. Per un elenco completo delle icone supportate, vedi icone integrate.
iconUrl	string Mostra un'icona personalizzata ospitata su un URL HTTPS. Ad esempio: "iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png" I tipi di file supportati includono .png e .jpg.
materialIcon	object (MaterialIcon) Mostra una delle icone di Google Material. Ad esempio, per visualizzare un'icona di casella di controllo, utilizza "materialIcon": { "name": "check_box" } Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

MaterialIcon

Un'icona di Google Material, che include oltre 2500 opzioni.

Ad esempio, per visualizzare un'icona di casella di controllo con spessore e livello personalizzati, scrivi quanto segue:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

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

Rappresentazione JSON
{ "name": string, "fill": boolean, "weight": integer, "grade": integer }

Campi
name	string Il nome dell'icona definito nell'icona di Google Material, ad esempio check_box. Eventuali nomi non validi vengono abbandonati e sostituiti con una stringa vuota, il che comporta il mancato rendering dell'icona.
fill	boolean Indica se l'icona viene visualizzata come riempita. Il valore predefinito è false. Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone dei caratteri Google e modifica le impostazioni in Personalizza.
weight	integer Lo spessore del tratto dell'icona. Scegli tra {100, 200, 300, 400, 500, 600, 700}. Se non è presente, il valore predefinito è 400. Se viene specificato un altro valore, viene utilizzato il valore predefinito. Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone dei caratteri Google e modifica le impostazioni in Personalizza.
grade	integer Lo spessore di un simbolo è influenzato dal tratto e dalla qualità. Le modifiche al voto sono più granulari rispetto a quelle al peso e hanno un impatto ridotto sulle dimensioni del simbolo. Scegli un'opzione tra {-25, 0, 200}. Se non è presente, il valore predefinito è 0. Se viene specificato un altro valore, viene utilizzato il valore predefinito. Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone dei caratteri Google e modifica le impostazioni in Personalizza.

DecoratedText

Un widget che mostra il testo con decorazioni facoltative, ad esempio 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 Google Chat, consulta Visualizzare il testo con testo decorativo.

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

Rappresentazione JSON
{ "icon": { object (Icon) }, "startIcon": { object (Icon) }, "topLabel": string, "text": string, "wrapText": boolean, "bottomLabel": string, "onClick": { object (OnClick) }, // Union field control can be only one of the following: "button": { object (Button) }, "switchControl": { object (SwitchControl) }, "endIcon": { object (Icon) } // End of list of possible types for union field control. }

Campi
icon (deprecated)	object (Icon) Questo elemento è deprecato. È stata sostituita da startIcon.
startIcon	object (Icon) L'icona visualizzata davanti al testo.
topLabel	string Il testo visualizzato sopra text. Viene sempre troncato.
text	string Obbligatorio. Il testo principale. Supporta la formattazione semplice. 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.
wrapText	boolean L'impostazione di a capo del testo. 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 topLabel e bottomLabel.
bottomLabel	string Il testo visualizzato sotto text. Si inserisce sempre un a capo.
onClick	object (OnClick) Questa azione viene attivata quando gli utenti fanno clic su topLabel o bottomLabel.
Campo unione control. Un pulsante, un'opzione, una casella di controllo o un'immagine visualizzata sul lato destro del testo nel decoratedText widget. control può essere solo uno dei seguenti:
button	object (Button) Un pulsante su cui un utente può fare clic per attivare un'azione.
switchControl	object (SwitchControl) Un widget di cambio su cui un utente può fare clic per modificare il proprio stato e attivare un'azione.
endIcon	object (Icon) Un'icona visualizzata dopo il testo. Supporta icone integrate e personalizzate.

Pulsante

Un pulsante di testo, un'icona o un pulsante di testo e icona su cui gli utenti possono fare clic. Per un esempio nelle app Google Chat, vedi Aggiungere un pulsante.

Per fare in modo che un'immagine sia un pulsante cliccabile, specifica un Image (non un ImageComponent) e imposta un'azione onClick.

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

Rappresentazione JSON
{ "text": string, "icon": { object (Icon) }, "color": { object (Color) }, "onClick": { object (OnClick) }, "disabled": boolean, "altText": string, "type": enum (Type) }

Campi
text	string Il testo visualizzato all'interno del pulsante.
icon	object (Icon) Un'icona visualizzata all'interno del pulsante. Se icon e text sono impostati, l'icona viene visualizzata prima del testo.
color	object (Color) (Facoltativo) Il colore del pulsante. Se impostato, il pulsante type è impostato su FILLED e il colore dei campi text e icon è impostato su un colore a contrasto per migliorare la leggibilità. Ad esempio, se il colore del pulsante è impostato sul blu, il testo o le icone nel pulsante sono impostati su bianco. Per impostare il colore del pulsante, specifica un valore per i campi red, green e blue. Il valore deve essere un numero con 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, di seguito viene impostato il colore rosso alla massima intensità: "color": { "red": 1, "green": 0, "blue": 0, } Il alpha campo non è disponibile per il colore del pulsante. Se specificato, questo campo viene ignorato.
onClick	object (OnClick) Obbligatorio. L'azione da eseguire quando un utente fa clic sul pulsante, ad esempio l'apertura di un link ipertestuale o l'esecuzione di una funzione personalizzata.
disabled	boolean Se true, il pulsante viene visualizzato in uno stato non attivo e non risponde alle azioni dell'utente.
altText	string Il testo alternativo utilizzato per l'accessibilità. Imposta un testo descrittivo che consenta agli utenti di sapere cosa fa il pulsante. Ad esempio, se un pulsante apre un link ipertestuale, potresti scrivere: "Apre una nuova scheda del browser e si accede alla documentazione per gli sviluppatori di Google Chat all'indirizzo https://developers.google.com/workspace/chat".
type	enum (Type) (Facoltativo) Il tipo di pulsante. Se non viene impostato, il tipo di pulsante predefinito è OUTLINED. Se il campo color è impostato, il tipo di pulsante viene impostato su FILLED e qualsiasi valore impostato per questo campo viene ignorato. Disponibile per le app Google Chat e per i componenti aggiuntivi di Google Workspace.

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per la semplicità della conversione da e verso le rappresentazioni dei colori in varie lingue rispetto alla compattezza. Ad esempio, i campi di questa rappresentazione possono essere forniti facilmente al costruttore di java.awt.Color in Java; possono anche essere forniti facilmente al metodo +colorWithRed:green:blue:alpha di UIColor in iOS; e, con un po' di lavoro, possono essere facilmente formattati in una stringa CSS rgba() in JavaScript.

Questa pagina di riferimento non contiene informazioni sullo spazio colore assoluto che dovrebbe essere utilizzato per interpretare il valore RGB, ad esempio sRGB, Adobe RGB, DCI-P3 e BT.2020. Per impostazione predefinita, le applicazioni dovrebbero assumere lo spazio colore sRGB.

Quando è necessario decidere l'uguaglianza dei colori, le implementazioni, salvo diversa indicazione, tratta i due colori come uguali se tutti i rispettivi valori di rosso, verde, blu e alfa differiscono di un massimo di 1e-5.

Esempio (Java):

 import com.google.type.Color;

 // ...
 public static java.awt.Color fromProto(Color protocolor) {
   float alpha = protocolor.hasAlpha()
       ? protocolor.getAlpha().getValue()
       : 1.0;

   return new java.awt.Color(
       protocolor.getRed(),
       protocolor.getGreen(),
       protocolor.getBlue(),
       alpha);
 }

 public static Color toProto(java.awt.Color color) {
   float red = (float) color.getRed();
   float green = (float) color.getGreen();
   float blue = (float) color.getBlue();
   float denominator = 255.0;
   Color.Builder resultBuilder =
       Color
           .newBuilder()
           .setRed(red / denominator)
           .setGreen(green / denominator)
           .setBlue(blue / denominator);
   int alpha = color.getAlpha();
   if (alpha != 255) {
     result.setAlpha(
         FloatValue
             .newBuilder()
             .setValue(((float) alpha) / denominator)
             .build());
   }
   return resultBuilder.build();
 }
 // ...

Esempio (iOS / Obj-C):

 // ...
 static UIColor* fromProto(Color* protocolor) {
    float red = [protocolor red];
    float green = [protocolor green];
    float blue = [protocolor blue];
    FloatValue* alpha_wrapper = [protocolor alpha];
    float alpha = 1.0;
    if (alpha_wrapper != nil) {
      alpha = [alpha_wrapper value];
    }
    return [UIColor colorWithRed:red green:green blue:blue alpha:alpha];
 }

 static Color* toProto(UIColor* color) {
     CGFloat red, green, blue, alpha;
     if (![color getRed:&red green:&green blue:&blue alpha:&alpha]) {
       return nil;
     }
     Color* result = [[Color alloc] init];
     [result setRed:red];
     [result setGreen:green];
     [result setBlue:blue];
     if (alpha <= 0.9999) {
       [result setAlpha:floatWrapperWithValue(alpha)];
     }
     [result autorelease];
     return result;
}
// ...

Esempio (JavaScript):

// ...

var protoToCssColor = function(rgb_color) {
   var redFrac = rgb_color.red || 0.0;
   var greenFrac = rgb_color.green || 0.0;
   var blueFrac = rgb_color.blue || 0.0;
   var red = Math.floor(redFrac * 255);
   var green = Math.floor(greenFrac * 255);
   var blue = Math.floor(blueFrac * 255);

   if (!('alpha' in rgb_color)) {
      return rgbToCssColor(red, green, blue);
   }

   var alphaFrac = rgb_color.alpha.value || 0.0;
   var rgbParams = [red, green, blue].join(',');
   return ['rgba(', rgbParams, ',', alphaFrac, ')'].join('');
};

var rgbToCssColor = function(red, green, blue) {
  var rgbNumber = new Number((red << 16) | (green << 8) | blue);
  var hexString = rgbNumber.toString(16);
  var missingZeros = 6 - hexString.length;
  var resultBuilder = ['#'];
  for (var i = 0; i < missingZeros; i++) {
     resultBuilder.push('0');
  }
  resultBuilder.push(hexString);
  return resultBuilder.join('');
};

// ...

Rappresentazione JSON
{ "red": number, "green": number, "blue": number, "alpha": number }

Campi
red	number La quantità di rosso nel colore come valore compreso nell'intervallo [0, 1].
green	number La quantità di verde nel colore come valore compreso nell'intervallo [0, 1].
blue	number La quantità di blu nel colore come valore nell'intervallo [0, 1].
alpha	number La frazione di questo colore da applicare al pixel. In altre parole, il colore finale dei pixel è definito dall'equazione: pixel color = alpha * (this color) + (1.0 - alpha) * (background color) Ciò significa che un valore di 1,0 corrisponde a un colore a tinta unita, mentre un valore di 0,0 corrisponde a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice scalare in virgola mobile in modo che sia possibile distinguere tra un valore predefinito e il valore non impostato. Se omesso, questo oggetto di colore viene visualizzato come un colore a tinta unita (come se al valore alfa fosse stato assegnato esplicitamente un valore di 1,0).

Tipo

(Facoltativo) Il tipo di un pulsante. Se il campo color è impostato, type viene forzato su FILLED.

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

Enum
TYPE_UNSPECIFIED	Non utilizzare. Non specificato.
OUTLINED	I pulsanti con contorni sono pulsanti con enfasi media. In genere contengono azioni importanti, ma non sono l'azione principale in un'app di Chat o in un componente aggiuntivo.
FILLED	Un pulsante con riempimento ha un contenitore con un colore a tinta unita. Ha l'impatto visivo maggiore ed è consigliato per l'azione importante e principale in un'app di chat o in un componente aggiuntivo.
FILLED_TONAL	Un pulsante con tonalità riempita è una via di mezzo alternativa tra i pulsanti con riempimento e quelli con contorni. Sono utili in contesti in cui un pulsante con priorità inferiore richiede un'enfasi leggermente maggiore rispetto a quella di un pulsante con contorni.
BORDERLESS	Un pulsante non ha un contenitore invisibile nello stato predefinito. Viene spesso utilizzata per le azioni con priorità più bassa, soprattutto quando si presentano più opzioni.

SwitchControl

Un'opzione di tipo Attiva/Disattiva o una casella di controllo all'interno di un decoratedText widget.

Disponibile per le app 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 il widget di opzione viene identificato in un evento di inserimento di un modulo. Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
value	string Il valore inserito da un utente, restituito come parte di un evento di input modulo. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.
selected	boolean Quando true, l'opzione è selezionata.
onChangeAction	object (Action) L'azione da eseguire quando lo stato dell'opzione cambia, ad esempio la funzione da eseguire.
controlType	enum (ControlType) Come viene visualizzato il pulsante di attivazione/disattivazione nell'interfaccia utente. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.

ControlType

Come viene visualizzato il pulsante di attivazione/disattivazione nell'interfaccia utente.

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

Enum
SWITCH	Un interruttore di tipo a pulsante.
CHECKBOX	È stata sostituita da CHECK_BOX.
CHECK_BOX	Una casella di controllo.

ButtonList

Un elenco di pulsanti disposti orizzontalmente. Per un esempio nelle app Google Chat, vedi Aggiungere un pulsante.

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

Rappresentazione JSON
{ "buttons": [ { object (Button) } ] }

Campi
buttons[]	object (Button) Un array di pulsanti.

TextInput

Un campo in cui gli utenti possono inserire del testo. Supporta i suggerimenti e le azioni in caso di modifica. Per un esempio nelle app Google Chat, vedi Aggiungere 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 inserimento del modulo. Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.

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

Disponibile per le app 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 }

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 Ricevere i dati dei moduli.
label	string Il testo visualizzato sopra il campo di immissione di testo nell'interfaccia utente. Specifica un testo che aiuti l'utente a inserire le informazioni necessarie per la 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. In caso contrario, facoltativo.
hintText	string Testo visualizzato sotto il campo di immissione di testo per aiutare gli utenti chiedendo di inserire un determinato valore. Questo testo è sempre visibile. Obbligatorio se label non è specificato. In caso contrario, facoltativo.
value	string Il valore inserito da un utente, restituito nell'ambito di un evento di inserimento di un modulo. Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
type	enum (Type) Come viene visualizzato un campo di immissione di testo nell'interfaccia utente. Ad esempio, se il campo è a una o più righe.
onChangeAction	object (Action) Cosa fare quando si verifica una modifica nel campo di immissione del testo. Ad esempio, un utente che aggiunge testo al campo o lo elimina. Alcuni esempi di azioni da intraprendere sono 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 del testo. Mentre gli utenti digitano, i valori suggeriti vengono filtrati in modo dinamico per corrispondere alle parole digitate dagli utenti. 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 in modo da mostrare solo Java e JavaScript. I valori suggeriti aiutano gli utenti a inserire valori con cui la tua app può avere un senso. Quando si fa riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Suggerendo JavaScript puoi 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 Google Chat e i componenti aggiuntivi di Google Workspace.
autoCompleteAction	object (Action) (Facoltativo) Specifica quale azione eseguire quando il campo di immissione di testo fornisce suggerimenti agli utenti che interagiscono con questo campo. Se non specificato, i suggerimenti vengono impostati da initialSuggestions e vengono elaborati dal cliente. Se specificata, 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) Anteprima per sviluppatori: disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Specifica la convalida necessaria per questo campo di immissione di testo. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
placeholderText	string Il testo visualizzato nel campo di immissione di testo quando il campo è vuoto. Utilizza questo testo per richiedere 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.

Tipo

La modalità di visualizzazione di un campo di immissione di testo nell'interfaccia utente. Ad esempio, se si tratta di un campo di immissione a una riga o di un input multiriga. Se initialSuggestions è specificato, type è sempre SINGLE_LINE, anche se è impostato su MULTIPLE_LINE.

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

Enum
SINGLE_LINE	Il campo di immissione testo ha un'altezza fissa di una riga.
MULTIPLE_LINE	Il campo di immissione del 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 Chat di eseguire un'azione specifica per l'app.

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

Campi
action	Action

Azione

Campi
navigations[]	Navigation Invia o aggiorna le schede visualizzate.

Navigazione

Aggiungi una nuova scheda alla pila (vai avanti). Per le app di Chat, disponibile solo per la home page dell'app.

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

navigations: {
  pushCard: CARD
}

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

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

navigations: {
  updateCard: CARD
}

Campi
Campo unione navigate_action. navigate_action può essere solo uno dei seguenti:
pushCard	Card La pila di carte spinge una carta sulla pila di carte.
updateCard	Card La serie di schede aggiorna la scheda in alto con una nuova scheda e conserva i valori dei campi del modulo compilati. Per un campo non equivalente, il valore viene ignorato.

Suggerimenti

Valori suggeriti che gli utenti possono inserire. Questi valori vengono visualizzati quando gli utenti fanno clic all'interno del campo di immissione testo. Mentre gli utenti digitano, i valori suggeriti vengono filtrati in modo dinamico per corrispondere alle parole digitate dagli utenti.

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

I valori suggeriti aiutano gli utenti a inserire valori con cui la tua app può avere un senso. Quando fanno riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. I suggerimenti JavaScript possono 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 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 Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON
{ // Union field content can be only one of the following: "text": string // End of list of possible types for union field content. }

Campi
Campo unione content. content può essere solo uno dei seguenti:
text	string Il valore di un input suggerito in un campo di immissione di testo. Corrisponde a quanto inserito dagli utenti.

Convalida

Anteprima per sviluppatori: disponibile nell'ambito del programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima a determinate funzionalità.

Rappresenta i dati necessari per la convalida del widget a cui è associato.

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

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

Campi
characterLimit	integer Anteprima per sviluppatori: disponibile nell'ambito del Programma Anteprima per sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Specifica il limite di caratteri per i widget di immissione di testo. Tieni presente che viene utilizzato solo per l'input di testo e viene ignorato per gli altri widget. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
inputType	enum (InputType) Anteprima per gli sviluppatori: disponibile nell'ambito del Programma Anteprima per gli sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Specifica il tipo di widget di input. Disponibile per le app 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.

SelectionInput

Un widget che crea uno o più elementi dell'interfaccia utente che gli utenti possono selezionare. Ad esempio, un menu a discesa o delle caselle di controllo. Puoi utilizzare questo widget per raccogliere dati che possono essere previsti o enumerati. Per un esempio nelle app Google Chat, consulta Aggiungere elementi dell'interfaccia utente 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 TextInput widget.

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

Rappresentazione JSON

{ "name": string, "label": string, "type": enum (SelectionType), "items": [ { object (SelectionItem) } ], "onChangeAction": { object (Action) }, "multiSelectMaxSelectedItems": integer, "multiSelectMinQueryLength": integer, "validation": { object (Validation) }, // Union field multi_select_data_source can be only one of the following: "externalDataSource": { object (Action) }, "platformDataSource": { object (PlatformDataSource) } // End of list of possible types for union field multi_select_data_source. }

Campi
name	string Obbligatorio. Il nome che identifica l'input di selezione in un evento di input modulo. Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
label	string Il testo visualizzato sopra il campo di immissione della selezione nell'interfaccia utente. Specifica un testo che aiuti l'utente a inserire le informazioni necessarie per la 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 visualizzati agli utenti in un SelectionInput widget. 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 specificato, devi specificare un pulsante separato che invii il modulo. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.
multiSelectMaxSelectedItems	integer Per i menu con selezione multipla, il numero massimo di elementi che un utente può selezionare. Il valore minimo è 1 articolo. Se non specificato, il valore predefinito è 3 elementi.
multiSelectMinQueryLength	integer Per i menu a più opzioni, 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 di selezione multipla utilizza i seguenti valori predefiniti: Se il menu utilizza un array statico di SelectionInput elementi, il valore predefinito è 0 caratteri e compila immediatamente gli elementi dell'array. Se il menu utilizza un'origine dati dinamica (multi_select_data_source), il valore predefinito è 3 caratteri prima di eseguire una query sull'origine dati per restituire gli elementi suggeriti.
validation	object (Validation) Per i menu a discesa, la convalida di questo campo di immissione di selezione. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.
Campo unione multi_select_data_source. Per un menu a più scelte, 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. multi_select_data_source può essere solo uno dei seguenti:
externalDataSource	object (Action) Un'origine dati esterna, ad esempio un database relazionale.
platformDataSource	object (PlatformDataSource) Un'origine dati di Google Workspace.

SelectionType

Il formato degli elementi che gli utenti possono selezionare. Le varie 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. La combinazione di caselle di controllo e opzioni, ad esempio, non è supportata.

Disponibile per le app 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 solo pulsante di opzione.
SWITCH	Un insieme di interruttori. Gli utenti possono attivare uno o più sensori.
DROPDOWN	Un menu a discesa. Gli utenti possono selezionare un elemento dal menu.
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 man mano che 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 più scelte, 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 al di fuori di Google Workspace. Per esempi su come implementare i menu a selezione multipla per le app di Chat, consulta Aggiungere un menu a selezione multipla. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.

SelectionItem

Un elemento che gli utenti possono selezionare in un input di selezione, ad esempio una casella di controllo o un'opzione. Supporta fino a 100 elementi.

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

Rappresentazione JSON
{ "text": string, "value": string, "selected": boolean, "startIconUri": string, "bottomText": string }

Campi
text	string Il testo che identifica o descrive l'articolo agli utenti.
value	string Il valore associato a questo elemento. Il cliente deve utilizzarlo come valore di input del modulo. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.
selected	boolean Indica se l'elemento è selezionato per impostazione predefinita. Se l'input di selezione accetta un solo valore (ad esempio per i pulsanti di opzione o un menu a discesa), imposta questo campo solo per un elemento.
startIconUri	string Per i menu a selezione multipla, l'URL dell'icona visualizzata accanto al campo text dell'elemento. Supporta i file PNG e JPEG. Deve essere un URL HTTPS. Ad esempio, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
bottomText	string Per i menu a selezione multipla, una descrizione o un'etichetta di testo visualizzata sotto il campo text dell'elemento.

PlatformDataSource

Per un widget SelectionInput che utilizza un menu a selezione multipla, un'origine dati di Google Workspace. Utilizzato per completare 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
{ // Union field data_source can be only one of the following: "commonDataSource": enum (CommonDataSource), "hostAppDataSource": { object (HostAppDataSourceMarkup) } // End of list of possible types for union field data_source. }

Campi
Campo unione data_source. L'origine dati. data_source può essere solo uno dei seguenti:
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 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 Installare le librerie client.

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 propria organizzazione Google Workspace.

HostAppDataSourceMarkup

Per un SelectionInput widget che utilizza un menu di selezione multipla, un'origine dati di un'applicazione Google Workspace. L'origine dati completa gli elementi di selezione per il menu a selezione multipla.

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

Rappresentazione JSON
{ // Union field data_source can be only one of the following: "chatDataSource": { object (ChatClientDataSourceMarkup) } // End of list of possible types for union field data_source. }

Campi
Campo unione data_source. L'applicazione Google Workspace che compila gli elementi di un menu a selezione multipla. data_source può essere solo uno dei seguenti:
chatDataSource	object (ChatClientDataSourceMarkup) Un'origine dati di Google Chat.

ChatClientDataSourceMarkup

Per un SelectionInput widget che utilizza un menu di 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
{ // Union field source can be only one of the following: "spaceDataSource": { object (SpaceDataSource) } // End of list of possible types for union field source. }

Campi
Campo unione source. L'origine dati di Google Chat. source può essere solo uno dei seguenti:
spaceDataSource	object (SpaceDataSource) Gli spazi di Google Chat di cui l'utente è membro.

SpaceDataSource

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

Disponibile per le app Google Chat e 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 Google Chat corrente come elemento per impostazione predefinita.

DateTimePicker

Consente agli utenti di inserire una data, un'ora o entrambe. Per un esempio nelle app Google Chat, consulta Consentire a un utente di scegliere una data e un'ora.

Gli utenti possono inserire del testo o utilizzare il selettore per selezionare date e orari. Se gli utenti inseriscono una data o un'ora non valide, il selettore mostra un errore che chiede agli utenti di inserire le informazioni correttamente.

Disponibile per le app 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) }, "validation": { object (Validation) } }

Campi
name	string Il nome con cui DateTimePicker è identificato in un evento di inserimento di un modulo. Per informazioni dettagliate sull'utilizzo degli input dei moduli, consulta Ricevere i dati dei moduli.
label	string Il testo che chiede agli utenti di inserire una data, un'ora o una data e un'ora. Ad esempio, se gli utenti stanno pianificando 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, un'ora o la data e l'ora.
valueMsEpoch	string (int64 format) Il valore predefinito visualizzato nel widget, in millisecondi dal tempo di Unix epoch. 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 ore 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 UTC. Ad esempio, per rappresentare le 12:00, utilizza 43200000 (o 12 * 60 * 60 * 1000).
timezoneOffsetDate	integer Il numero che rappresenta la differenza di fuso orario rispetto a UTC, in minuti. Se impostato, valueMsEpoch viene visualizzato nel fuso orario specificato. Se non viene configurato, il valore predefinito corrisponde all'impostazione del fuso orario dell'utente.
onChangeAction	object (Action) Si attiva quando l'utente fa clic su Salva o su Cancella nell'interfaccia DateTimePicker.
validation	object (Validation) Anteprima per gli sviluppatori: disponibile nell'ambito del Programma Anteprima per gli sviluppatori di Google Workspace, che concede l'accesso in anteprima ad alcune funzionalità. Facoltativo. Specifica la convalida richiesta per questo selettore di date e timer. Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace.

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 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 orario.

Divisore

Questo tipo non contiene campi.

Mostra un divisore tra i widget sotto forma di linea orizzontale. Per un esempio nelle app Google Chat, vedi Aggiungere un divisore orizzontale tra i widget.

Disponibile per le app 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 più di testo o immagini, utilizza Columns. Per un esempio nelle app Google Chat, consulta Visualizzare una griglia con una raccolta di elementi.

Una griglia supporta un numero illimitato 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 Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, il seguente JSON crea una griglia a 2 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 è specificato, viene utilizzato un valore predefinito diverso a seconda di dove viene visualizzata la griglia (dialogo o companion).
onClick	object (OnClick) Questo callback viene riutilizzato da ogni singolo elemento della griglia, ma con l'identificatore e l'indice dell'elemento nell'elenco di elementi aggiunti ai parametri del callback.

GridItem

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

Disponibile per le app 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 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 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 Google Chat e i componenti aggiuntivi di Google Workspace.

Ad esempio, ecco come applicare proporzioni 16:9:

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

Rappresentazione JSON
{ "type": enum (ImageCropType), "aspectRatio": number }

Campi
type	enum (ImageCropType) Il tipo di ritaglio.
aspectRatio	number Le proporzioni da utilizzare se il tipo di ritaglio è RECTANGLE_CUSTOM. Ad esempio, ecco come applicare proporzioni 16:9: cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }

ImageCropType

Rappresenta lo stile di ritaglio applicato a un'immagine.

Disponibile per le app 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 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 con 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, di seguito viene impostato il colore rosso alla massima intensità: "color": { "red": 1, "green": 0, "blue": 0, } Il alpha campo non è disponibile per il colore del tratto. Se specificato, questo campo viene ignorato.
cornerRadius	integer Il raggio d'angolo del bordo.

BorderType

Rappresenta i tipi di bordi applicati ai widget.

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

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

GridItemLayout

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

Disponibile per le app 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 mostra 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, vedi Visualizzare schede e finestre di dialogo nelle colonne.

L'altezza di ogni colonna è determinata dalla colonna più alta. Ad esempio, se la prima colonna è più alta della seconda colonna, entrambe 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 stretta, la seconda colonna si inserisce sotto la prima:

• Sul web, la seconda colonna viene a capo se la larghezza dello schermo è inferiore o uguale a 480 pixel.
• Sui dispositivi iOS, la seconda colonna viene 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, usa il widget Grid.

Disponibile per le app 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 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 devono essere 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 occupa 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, ciascuna colonna riempie il 50% dello spazio.
FILL_MINIMUM_SPACE	La colonna deve occupare il minor spazio possibile e non più del 30% della larghezza della scheda.

HorizontalAlignment

Specifica se i widget devono essere 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, viene allineato 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, i widget vengono allineati a destra. Per i layout da destra a sinistra, i widget vengono allineati a sinistra.

VerticalAlignment

Specifica se i widget devono essere allineati alla parte superiore, inferiore 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

{ // Union field data can be only one of the following: "textParagraph": { object (TextParagraph) }, "image": { object (Image) }, "decoratedText": { object (DecoratedText) }, "buttonList": { object (ButtonList) }, "textInput": { object (TextInput) }, "selectionInput": { object (SelectionInput) }, "dateTimePicker": { object (DateTimePicker) }, "chipList": { object (ChipList) } // End of list of possible types for union field data. }

Campi
Campo unione data. data può essere solo uno dei seguenti:
textParagraph	object (TextParagraph) Widget TextParagraph.
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. Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

ChipList

Un elenco di chip disposti orizzontalmente, che può scorrere orizzontalmente o andare a capo nella riga successiva.

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

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

Campi
layout	enum (Layout) Layout dell'elenco di chip specificato.
chips[]	object (Chip) Un array di chip.

Layout

Il layout dell'elenco di chip.

Enum
LAYOUT_UNSPECIFIED	Non utilizzare. Non specificato.
WRAPPED	Valore predefinito. L'elenco dei chip viene a capo nella riga successiva se non c'è spazio orizzontale sufficiente.
HORIZONTAL_SCROLLABLE	I chip scorrono orizzontalmente 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 Google Chat e per 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 icon e text sono impostati, l'icona viene visualizzata prima del testo.
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 Questo elemento è deprecato. Indica se il chip è in uno stato attivo e risponde alle azioni dell'utente. Il valore predefinito è true. Deprecato. Utilizza disabled al suo posto.
disabled	boolean Indica se il chip è in stato inattivo 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 si accede alla documentazione per gli sviluppatori di Google Chat all'indirizzo https://developers.google.com/workspace/chat".

CollapseControl

Rappresenta un controllo di espansione e compressione. Disponibile per le app Google Chat e non disponibile per 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 Espandi e comprimi.
expandButton	object (Button) (Facoltativo) Definisci un pulsante personalizzabile per espandere la sezione. È necessario impostare entrambi i campi expandButton e collapseButton. Solo un insieme di campi non verrà applicato. Se questo campo non è impostato, viene utilizzato il pulsante predefinito.
collapseButton	object (Button) (Facoltativo) Definisci un pulsante personalizzabile per comprimere la sezione. È necessario impostare sia il campo espandibiliButton che il campo CompressButton. Un solo set di campi non verrà applicato. Se questo campo non è impostato, viene utilizzato il pulsante predefinito.

DividerStyle

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

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

Enum
DIVIDER_STYLE_UNSPECIFIED	Non utilizzare. Non specificato.
SOLID_DIVIDER	Opzione predefinita. Mostra un divisore pieno.
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 eliminare la fattura, inviare la fattura via email o aprirla in un browser.

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

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

Campi
actionLabel	string L'etichetta visualizzata come elemento del menu di azioni.
onClick	object (OnClick) L'azione onClick per questo elemento dell'attività.

CardFixedFooter

Un piè di pagina permanente (bloccato) visualizzato in fondo alla scheda.

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

Per le app di chat, puoi utilizzare piè di pagina fissi nelle finestre di dialogo, ma non nei messaggi delle schede. Per un esempio nelle app Google Chat, consulta Aggiungere un piè di pagina permanente.

Disponibile per le app 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 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 superiore corrente della serie. Se fai clic sull'intestazione, la scheda viene visualizzata nella pila di schede. Se la scheda non ha un'intestazione, viene utilizzata un'intestazione generata.
REPLACE	Valore predefinito. La scheda viene visualizzata sostituendo la visualizzazione della scheda in alto nella serie di schede.