Cards v2

Scheda

Un'interfaccia a schede 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 pulsanti e contenuti rich media come le immagini. Utilizza le schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e aiutarli a compiere un passo successivo.

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

Apri Card Builder

Per informazioni su come creare le schede, consulta la seguente documentazione:

Esempio: messaggio di carta per un'app Google Chat

Esempio di scheda contatto

Per creare il messaggio di 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/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)
  }
}
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 una propria intestazione facoltativa. Le sezioni sono visivamente separate da un divisore di linea. Per un esempio nelle app Google Chat, consulta la sezione delle schede.

sectionDividerStyle

enum (DividerStyle)

Lo stile del divisore tra le sezioni.

cardActions[]

object (CardAction)

Le azioni della scheda. Le azioni vengono aggiunte al menu della barra degli strumenti della scheda.

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

Ad esempio, il seguente JSON crea un menu azione 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 carta nella navigazione delle carte.

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

displayStyle

enum (DisplayStyle)

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

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

peekCardHeader

object (CardHeader)

Quando visualizzi contenuti contestuali, l'intestazione della scheda breve funge da segnaposto per consentire all'utente di spostarsi in avanti tra le schede della home page e quelle contestuali.

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

CardHeader

Rappresenta l'intestazione di una scheda. Per un esempio nelle app Google Chat, vedi Intestazione della scheda.

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 sono specificati sia un titolo che un sottotitolo, ognuno occupa una riga. Se viene specificato solo il titolo, 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 utilizzata 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 4 x 3 diventa 3 x 3.
CIRCLE Applica una maschera circolare all'immagine. Ad esempio, un'immagine 4 x 3 diventa un cerchio con un diametro di 3.

Sezione

Una sezione contiene una raccolta di widget visualizzati verticalmente nell'ordine specificato.

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

Rappresentazione JSON
{
  "header": string,
  "widgets": [
    {
      object (Widget)
    }
  ],
  "collapsible": boolean,
  "uncollapsibleWidgetsCount": integer
}
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, vedi Formattazione del testo nelle app Google Chat e Formattazione del testo nei componenti aggiuntivi di Google Workspace.

widgets[]

object (Widget)

Tutti i widget nella 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 è compressa.

Ad esempio, quando 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.

Widget

Ogni scheda è composta da widget.

Un widget è un oggetto composito che può rappresentare testi, 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)
  }
  // End of list of possible types for union field data.
}
Campi
horizontalAlignment

enum (HorizontalAlignment)

Consente di specificare se i widget si allineano a sinistra, a destra o al centro di una colonna.

Campo di unione data. Un widget può avere solo uno dei seguenti elementi. È possibile utilizzare più campi widget per visualizzare più elementi. data può essere solo uno dei seguenti:
textParagraph

object (TextParagraph)

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

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

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

object (Image)

Visualizza un'immagine.

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

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

object (DecoratedText)

Mostra un elemento di testo decorato.

Ad esempio, il codice JSON seguente 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 codice JSON seguente crea due pulsanti. Il primo è un pulsante di testo blu, mentre il secondo è un pulsante immagine che apre un link:

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
        "alpha": 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 codice JSON seguente crea un input di testo per un indirizzo email:

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

Come ulteriore 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 dimensione:

"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 data, ora o data e 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 uno spartitore 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 illimitato di colonne ed elementi. Il numero di righe viene determinato dal limite superiore degli elementi numerici 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 codice JSON seguente 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"
    }
  }
}
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 contenenti ciascuna 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"
          }
        }
      ]
    }
  ]
}

TextParagraph

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

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

Rappresentazione JSON
{
  "text": string
}
Campi
text

string

Il testo visualizzato nel widget.

Immagine

Un'immagine specificata da un URL e che può avere un'azione onClick. Per un esempio, vedi 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/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 utilizzata per l'accessibilità.

OnClick

Rappresenta come rispondere 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)
  }
  // End of list of possible types for union field data.
}
Campi

Campo di unione data.

data può essere solo uno dei seguenti:

action

object (Action)

Se specificata, viene attivata un'azione da questo elemento onClick.

card

object (Card)

Se specificato, una nuova scheda viene inviata alla pila di schede dopo aver fatto clic.

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

Azione

Azione che descrive il comportamento quando viene inviato il modulo. 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)
}
Campi
function

string

Una funzione personalizzata da richiamare quando viene fatto clic sull'elemento contenitore o quando viene attivato in altro modo.

Ad esempio, consulta la sezione Creare schede interattive.

parameters[]

object (ActionParameter)

Elenco dei parametri di azione.

loadIndicator

enum (LoadIndicator)

Specifica l'indicatore di caricamento visualizzato dall'azione durante l'invito all'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 delle schede nelle app di chat, devi anche impostare l'azione ResponseType su UPDATE_MESSAGE e utilizzare la stessa 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)

Campo facoltativo. Obbligatorio quando si apre una finestra di dialogo.

Cosa fare in risposta a un'interazione con un utente, ad esempio un utente che fa clic su un pulsante in un messaggio di scheda.

Se non specificata, l'app risponde mediante l'esecuzione di un action, come l'apertura di un link o l'esecuzione di una funzione, come di consueto.

Se specifichi un valore 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, l'indicatore di caricamento non viene mostrato. Se specificata per un componente aggiuntivo, l'intera scheda viene rimossa e non viene visualizzato nulla nel client.

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

ActionParameter

Elenco dei parametri di stringa da fornire quando viene richiamato il metodo di azione. Ad esempio, prendi in considerazione tre pulsanti per posticipare la sveglia: ora, posticipa un giorno o posticipa la settimana successiva. Puoi utilizzare action method = snooze(), passando il tipo di posticipazione e il tempo di posticipazione nell'elenco dei parametri di stringa.

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 l'action script.

value

string

Il valore del parametro.

LoadIndicator

Specifica l'indicatore di caricamento visualizzato dall'azione durante l'invito all'azione.

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

Enum
SPINNER Mostra una rotellina per indicare che i contenuti sono in fase di caricamento.
NONE Non viene visualizzato nulla.

Interazione

Campo facoltativo. Obbligatorio quando si apre una finestra di dialogo.

Cosa fare in risposta a un'interazione con un utente, ad esempio un utente che fa clic su un pulsante in un messaggio di scheda.

Se non specificata, l'app risponde mediante l'esecuzione di un action, come l'apertura di un link o l'esecuzione di una funzione, come di consueto.

Se specifichi un valore 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, l'indicatore di caricamento non viene mostrato. Se specificata per un componente aggiuntivo, l'intera scheda viene rimossa e non viene visualizzato nulla nel client.

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

Enum
INTERACTION_UNSPECIFIED Valore predefinito. L'elemento action viene eseguito normalmente.
OPEN_DIALOG

Apre una finestra di dialogo, ovvero un'interfaccia con schede e finestre che le app di Chat utilizzano per interagire con gli utenti.

Funzionalità supportata solo dalle app di chat in risposta ai clic sui pulsanti nei messaggi delle schede. Se specificata per un componente aggiuntivo, l'intera scheda viene rimossa e non viene visualizzato nulla nel client.

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

OpenAs

Quando un'azione OnClick apre un link, il client può aprirlo come una finestra a grandezza originale (se questo è il 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 le supporta. FULL_SIZE è supportato da tutti i client.

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

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

OnClose

Ciò che fa il client quando un link aperto da un'azione OnClick viene chiuso.

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.

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

Enum
NOTHING Valore predefinito. La carta non viene ricaricata, quindi non succede nulla.
RELOAD

Ricarica la scheda dopo la chiusura della finestra secondaria.

Se utilizzata in combinazione con OpenAs.OVERLAY, la finestra secondaria funge da finestra di dialogo modale e la scheda principale viene bloccata fino a quando la finestra secondaria non viene chiusa.

DecoratedText

Un widget che mostra del 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, vedi Testo decorato.

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)

Deprecata a favore di startIcon.

startIcon

object (Icon)

L'icona visualizzata davanti al testo.

topLabel

string

Il testo visualizzato sopra text. Tronca sempre.

text

string

obbligatorio. Il testo principale.

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

wrapText

boolean

L'impostazione 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. Aggrega sempre.

onClick

object (OnClick)

Questa azione viene attivata quando gli utenti fanno clic su topLabel o bottomLabel.

Campo di unione control. Un pulsante, un'opzione, una casella di controllo o un'immagine visualizzati sul lato destro del testo nel widget decoratedText. control può essere solo uno dei seguenti:
button

object (Button)

Pulsante su cui l'utente può fare clic per attivare un'azione.

switchControl

object (SwitchControl)

Cambia widget 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.

Icona

Un'icona visualizzata in un widget su una scheda. Per un esempio nelle app Google Chat, vedi 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

Campo 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/chat.

Se l'icona è impostata in Button, altText viene visualizzata come testo di supporto 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 ritaglio CIRCLE fa sì che l'immagine venga disegnata più grande di un'icona integrata.

Campo di unione icons. L'icona visualizzata nel widget sulla 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 un autobus, specifica BUS.

Per un elenco completo delle icone supportate, consulta la sezione sulle icone integrate.

iconUrl

string

Mostra un'icona personalizzata ospitata su un URL HTTPS.

Ad esempio:

"iconUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png"

I tipi di file supportati includono .png e .jpg.

materialIcon

object (MaterialIcon)

Mostra una delle icone Material di Google.

Ad esempio, per visualizzare un'icona a forma 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 Google Material, che include oltre 2500 opzioni.

Ad esempio, per visualizzare un'icona di casella di controllo con peso e voto 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 Material Google, ad esempio check_box. I nomi non validi vengono abbandonati e sostituiti con una stringa vuota e l'icona non viene visualizzata.

fill

boolean

Se l'icona viene visualizzata come riempita. Il valore predefinito è false.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone di Google Font e regola le impostazioni nella sezione 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 qualsiasi altro valore, viene utilizzato il valore predefinito.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone di Google Font e regola le impostazioni nella sezione Personalizza.

grade

integer

Il peso e la qualità influiscono sullo spessore di un simbolo. Le regolazioni della correzione sono più granulari delle regolazioni della ponderazione e hanno un impatto minimo sulle dimensioni del simbolo. Scegli tra {-25, 0, 200}. Se non è presente, il valore predefinito è 0. Se viene specificato qualsiasi altro valore, viene utilizzato il valore predefinito.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Icone di Google Font e regola le impostazioni nella sezione Personalizza.

Pulsante

Un pulsante di testo, icona o testo e icona su cui gli utenti possono fare clic. Per un esempio nelle app Google Chat, consulta Elenco pulsanti.

Per rendere un'immagine 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
}
Campi
text

string

Il testo visualizzato all'interno del pulsante.

icon

object (Icon)

L'immagine dell'icona. Se sono impostati entrambi i criteri icon e text, l'icona viene visualizzata prima del testo.

color

object (Color)

Se impostato, il pulsante viene riempito con un colore di sfondo a tinta unita e il colore del carattere cambia per mantenere il contrasto con il colore di sfondo. Ad esempio, se imposti uno sfondo blu, probabilmente il testo sarà bianco.

Se il criterio non viene configurato, lo sfondo dell'immagine è bianco e il colore dei caratteri è blu.

Per il rosso, il verde e il blu, il valore di ogni campo è un numero float che puoi esprimere in due modi: come un numero compreso tra 0 e 255 diviso per 255 (153/255) o come valore compreso tra 0 e 1 (0,6). 0 rappresenta l'assenza di un colore e 1 o 255/255 rappresenta la piena presenza di quel colore sulla scala RGB.

(Facoltativo) Imposta alpha, che imposta un livello di trasparenza utilizzando questa equazione:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Per alpha, il valore 1 corrisponde a un colore a tinta unita, mentre il valore 0 corrisponde a un colore completamente trasparente.

Ad esempio, il seguente colore rappresenta un rosso semitrasparente:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
   "alpha": 0.5
}
onClick

object (OnClick)

obbligatorio. L'azione da eseguire quando un utente fa clic sul pulsante, ad esempio aprire un link ipertestuale o eseguire una funzione personalizzata.

disabled

boolean

Se true, il pulsante viene visualizzato in stato non attivo e non risponde alle azioni dell'utente.

altText

string

Il testo alternativo utilizzato per l'accessibilità.

Imposta un testo descrittivo che indichi agli utenti la funzione del pulsante. Ad esempio, se un pulsante apre un link ipertestuale, potresti scrivere: "Apre una nuova scheda del browser e passa alla documentazione per gli sviluppatori di Google Chat all'indirizzo https://developers.google.com/chat".

Colore

Rappresenta un colore nello spazio colore RGBA. Questa rappresentazione è progettata per semplificare la conversione da e verso le rappresentazioni dei colori in vari linguaggi piuttosto che sulla compattezza. Ad esempio, i campi di questa rappresentazione possono essere banalimente forniti al costruttore di java.awt.Color in Java; possono anche essere forniti in modo banale al metodo +colorWithRed:green:blue:alpha di UIColor in iOS e, con un po' di lavoro, può essere facilmente formattato in una stringa rgba() CSS in JavaScript.

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

Quando è necessario stabilire la parità dei colori, le implementazioni, se non diversamente documentato, trattano due colori come se fossero uguali se tutti i valori di rosso, verde, blu e alpha differiscono al massimo 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 nell'intervallo [0, 1].

green

number

La quantità di verde nel colore come valore 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 pixel finale è definito dall'equazione:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

Ciò significa che il valore 1,0 corrisponde a un colore a tinta unita, mentre il valore 0,0 corrisponde a un colore completamente trasparente. Viene utilizzato un messaggio wrapper anziché un semplice valore scalare in virgola mobile, in modo che sia possibile distinguere tra un valore predefinito e il valore che viene annullato. Se omesso, questo oggetto colore viene visualizzato come un colore a tinta unita (come se al valore alfa fosse stato esplicitamente assegnato un valore di 1,0).

SwitchControl

Puoi selezionare un'opzione di attivazione/disattivazione o una casella di controllo all'interno di un widget decoratedText.

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

Funzionalità supportata 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 cambia viene identificato in un evento di input del modulo.

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

value

string

Il valore inserito da un utente, restituito come parte di un evento di input di un modulo.

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

selected

boolean

Quando true, l'opzione è selezionata.

onChangeAction

object (Action)

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

controlType

enum (ControlType)

Modalità di visualizzazione dell'opzione nell'interfaccia utente.

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

ControlType

Modalità di visualizzazione dell'opzione nell'interfaccia utente.

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

Enum
SWITCH Un pulsante di attivazione/disattivazione.
CHECKBOX Deprecata a favore di CHECK_BOX.
CHECK_BOX Una casella di controllo.

ButtonList

Un elenco di pulsanti disposti orizzontalmente. Per un esempio nelle app Google Chat, consulta Elenco pulsanti.

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 suggerimenti e azioni in caso di modifica. Per un esempio nelle app Google Chat, consulta Inserimento di testo.

Le app di chat ricevono ed elaborano il valore del testo inserito durante gli eventi di input del modulo. Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

Se devi raccogliere dati non definiti o astratti dagli utenti, utilizza un input di testo. Per raccogliere i 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)
  },
  "placeholderText": string
}
Campi
name

string

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

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

label

string

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

Specifica il testo che aiuta l'utente a inserire le informazioni necessarie all'app. Ad esempio, se vuoi chiedere il nome di una persona, ma ti serve il cognome, scrivi surname anziché name.

Obbligatorio se hintText non è specificato. Altrimenti, facoltativo.

hintText

string

Testo visualizzato sotto il campo di immissione di testo allo scopo di aiutare gli utenti 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 come parte di un evento di input di un modulo.

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

type

enum (Type)

Modalità di visualizzazione di un campo di immissione di testo nell'interfaccia utente. Ad esempio, se il campo è una o più righe.

onChangeAction

object (Action)

Che cosa fare quando si verifica una modifica nel campo di immissione testo. ad esempio quando un utente aggiunge un campo o elimina del testo.

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 nel campo di immissione testo. Mentre gli utenti digitano, i valori suggeriti vengono filtrati in modo dinamico per corrispondere a ciò che hanno digitato.

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 di filtri dei suggerimenti mostra solo Java e JavaScript.

I valori suggeriti aiutano gli utenti a inserire valori che la tua app possa interpretare. Quando fanno riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Se suggerisci 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)

Campo facoltativo. Specifica quale azione eseguire quando il campo di immissione testo fornisce suggerimenti agli utenti che interagiscono con quest'ultimo.

Se non specificati, i suggerimenti sono impostati da initialSuggestions e vengono elaborati dal client.

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

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

placeholderText

string

Testo visualizzato nel campo di immissione 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

Modalità di visualizzazione di un campo di immissione di testo nell'interfaccia utente. Ad esempio, se si tratta di un campo di immissione su una riga o su più righe. 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 testo ha un'altezza fissa con più righe.

RenderActions

Un insieme di istruzioni di visualizzazione che indicano a una scheda di eseguire un'azione o che indicano 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

Esegui il push o aggiorna le schede visualizzate.

Aggiungi una nuova scheda alla pila (vai avanti).

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

navigations: {
  pushCard: CARD
}

Sostituisci la carta superiore con una nuova.

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

navigations: {
  updateCard: CARD
}

Suggerimenti

Valori suggeriti che gli utenti possono inserire. Questi valori vengono visualizzati quando gli utenti fanno clic nel campo di immissione testo. Mentre gli utenti digitano, i valori suggeriti vengono filtrati in modo dinamico per corrispondere a ciò che hanno digitato.

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 dei suggerimenti da mostrare Java e JavaScript.

I valori suggeriti aiutano gli utenti a inserire valori che la tua app possa interpretare. Quando fanno riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Se suggerisci 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.

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

object (SuggestionItem)

Un elenco di suggerimenti utilizzati per i suggerimenti di completamento automatico nei campi di immissione 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 di unione content.

content può essere solo uno dei seguenti:

text

string

Il valore di un input suggerito in un campo di immissione di testo. Ciò equivale a ciò che gli utenti inseriscono personalmente.

SelectionInput

Un widget che crea uno o più elementi dell'interfaccia utente che gli utenti possono selezionare. Ad esempio, un menu a discesa o caselle di controllo. Puoi utilizzare questo widget per raccogliere i dati che possono essere previsti o enumerati. Per un esempio nelle app Google Chat, consulta Input di selezione.

Le app di chat possono elaborare il valore degli elementi selezionati o inseriti dagli utenti. Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

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

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,

  // 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

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

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

label

string

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

Specifica il testo che aiuta l'utente a inserire le informazioni necessarie all'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 selezionarne solo un 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 per l'invio del modulo.

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

multiSelectMaxSelectedItems

integer

Per i menu a 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 selezione multipla, il numero di caratteri di testo che un utente inserisce prima dell'esecuzione della query dell'app viene completato automaticamente e mostra le voci suggerite nel menu.

Se non specificato, il valore predefinito è 0 caratteri per le origini dati statiche e 3 caratteri per le origini dati esterne.

Campo di unione multi_select_data_source. Per un menu a selezione multipla, l'origine dati che completa gli elementi selezionati.

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. Diverse opzioni supportano diversi tipi di interazioni. Ad esempio, gli utenti possono selezionare più caselle di controllo, ma possono selezionare solo un 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 pulsante di opzione.
SWITCH Una serie di sensori. 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 a selezione multipla per dati statici o dinamici. Dalla barra dei menu, gli utenti selezionano una o più voci. Gli utenti possono anche inserire valori per completare i dati dinamici. Ad esempio, gli utenti possono iniziare a digitare il nome di uno spazio di Google Chat e il widget suggerisce automaticamente lo spazio.

Per completare gli elementi per un menu a selezione multipla, puoi utilizzare uno dei seguenti tipi di origini dati:

  • Dati statici: gli elementi vengono specificati come oggetti SelectionItem nel widget. Fino a 100 elementi.
  • Dati di Google Workspace: gli elementi vengono compilati utilizzando i dati di Google Workspace, come gli utenti di Google Workspace o gli spazi di Google Chat.
  • Dati esterni: gli elementi vengono completati da un'origine dati esterna esterna a Google Workspace.

Per esempi su come implementare i menu a selezione multipla, consulta la pagina del widget SelectionInput .

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. La selezione multipla per i componenti aggiuntivi di Google Workspace è in Anteprima per sviluppatori.

SelectionItem

Un elemento che gli utenti possono selezionare in un input di selezione, ad esempio una casella di controllo o un sensore.

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 client deve utilizzarlo come valore di input del modulo.

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere 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/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 di 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 di un'applicazione host di Google Workspace, come gli spazi in Google Chat.

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ò solo visualizzare e selezionare gli utenti della propria organizzazione Google Workspace.

HostAppDataSourceMarkup

Per un widget SelectionInput che utilizza un menu a 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 di unione data_source. L'applicazione Google Workspace che compila gli elementi per 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 widget SelectionInput che utilizza un menu a selezione multipla, un'origine dati di Google Chat. L'origine dati completa gli elementi di selezione per il menu a 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 di unione source. L'origine dati Google Chat. source può essere solo uno dei seguenti:
spaceDataSource

object (SpaceDataSource)

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 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 l'attuale spazio di Google Chat 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 il selettore di data e 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 richiede agli utenti di inserire correttamente le informazioni.

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)
  }
}
Campi
name

string

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

Per maggiori dettagli sull'utilizzo degli input dei moduli, consulta Ricevere dati dei moduli.

label

string

Il testo che richiede agli utenti di inserire una data, un'ora o una data e un'ora. Ad esempio, se gli utenti pianificano un appuntamento, utilizza un'etichetta come Appointment date o Appointment date and time.

type

enum (DateTimePickerType)

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 dalla data epoch di Unix.

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

  • DATE_AND_TIME : una data e un'ora di calendario in formato 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 orario in UTC. Ad esempio, per rappresentare le 12:00, utilizza 43200000 (o 12 * 60 * 60 * 1000).
timezoneOffsetDate

integer

Il numero che rappresenta la differenza, in minuti, del fuso orario UTC. Se impostato, l'valueMsEpoch viene visualizzato nel fuso orario specificato. Se non viene configurato, il valore predefinito corrisponde al fuso orario dell'utente.

onChangeAction

object (Action)

Si attiva quando l'utente fa clic su Salva o Cancella dall'interfaccia di DateTimePicker.

DateTimePickerType

Il formato di data e 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 la data e l'ora.
DATE_ONLY Gli utenti inseriscono una data.
TIME_ONLY Gli utenti inseriscono un orario.

Divisore

Questo tipo non contiene campi.

Visualizza un divisore tra i widget come una linea orizzontale. Per un esempio nelle app Google Chat, vedi Divisore.

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

Ad esempio, il seguente JSON crea un divisore:

"divider": {}

GRid

Mostra 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, vedi Griglia.

Una griglia supporta un numero illimitato di colonne ed elementi. Il numero di righe è determinato dal numero di elementi diviso 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 codice JSON seguente 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 ciascun elemento della griglia.

columnCount

integer

Il numero di colonne da visualizzare nella griglia. Se questo campo non viene specificato, viene utilizzato un valore predefinito diverso a seconda della posizione in cui viene visualizzata la griglia (finestra di dialogo e 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 degli elementi aggiunti ai parametri del callback.

GridItem

Rappresenta un elemento in 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 onClick parametri di callback 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à dell'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 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 ritaglio.

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 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 tipo e 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.

cornerRadius

integer

Il raggio d'angolo del bordo.

BorderType

Rappresenta i tipi di bordo 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. Senza 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 sono visualizzati sotto l'immagine dell'elemento della griglia.
TEXT_ABOVE Il titolo e il sottotitolo vengono mostrati sopra l'immagine dell'elemento della griglia.

Colonne

Il widget Columns mostra fino a due colonne in una scheda o 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 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. 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 affiancate. Puoi personalizzare la larghezza di ogni colonna utilizzando il campo HorizontalSizeStyle. Se la larghezza dello schermo dell'utente è troppo ridotta, la seconda colonna va a capo 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 Google Chat e i componenti aggiuntivi di Google Workspace. Le colonne relative ai componenti aggiuntivi di Google Workspace sono in Anteprima per sviluppatori.

Rappresentazione JSON
{
  "columnItems": [
    {
      object (Column)
    }
  ]
}
Campi
columnItems[]

object (Column)

Un array di colonne. In una scheda o una finestra di dialogo puoi includere fino a due colonne.

Colonna

Una colonna.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. Le colonne relative ai componenti aggiuntivi di Google Workspace sono in Anteprima per sviluppatori.

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

enum (HorizontalSizeStyle)

Specifica il modo in cui una colonna riempie la larghezza della scheda.

horizontalAlignment

enum (HorizontalAlignment)

Consente di specificare se i widget si allineano a sinistra, a destra o al centro di una colonna.

verticalAlignment

enum (VerticalAlignment)

Consente di specificare se i widget vengono allineati nella parte superiore, inferiore o centrale 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 il modo in cui una colonna riempie la larghezza della scheda. La larghezza di ogni colonna dipende sia da HorizontalSizeStyle sia dalla larghezza dei widget all'interno della colonna.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. Le colonne relative ai componenti aggiuntivi di Google Workspace sono in Anteprima per sviluppatori.

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 riempie il 50% dello spazio.
FILL_MINIMUM_SPACE La colonna riempie la quantità minima di spazio possibile e non più del 30% della larghezza della scheda.

HorizontalAlignment

Consente di specificare se i widget si allineano 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, allinea a sinistra. Per i layout da destra a sinistra, allinea 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

Consente di specificare se i widget vengono allineati nella parte superiore, inferiore o centrale di una colonna.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. Le colonne relative ai componenti aggiuntivi di Google Workspace sono in Anteprima per sviluppatori.

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

Widget

I widget supportati che puoi includere in una colonna.

Disponibile per le app Google Chat e i componenti aggiuntivi di Google Workspace. Le colonne relative ai componenti aggiuntivi di Google Workspace sono in Anteprima per sviluppatori.

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)
  }
  // End of list of possible types for union field data.
}
Campi

Campo di unione data.

data può essere solo uno dei seguenti:

textParagraph

object (TextParagraph)

widget TextParagraph.

image

object (Image)

widget Image.

decoratedText

object (DecoratedText)

widget DecoratedText.

buttonList

object (ButtonList)

widget ButtonList.

textInput

object (TextInput)

widget TextInput.

selectionInput

object (SelectionInput)

widget SelectionInput.

dateTimePicker

object (DateTimePicker)

widget DateTimePicker.

DividerStyle

Lo stile del divisore di una carta. Attualmente utilizzato solo per i divisori 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. Esegui il rendering di un solido divisore tra le sezioni.
NO_DIVIDER Se impostato, non viene visualizzato alcun divisore tra le sezioni.

CardAction

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

Disponibili 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 che viene visualizzata come voce del menu azione.

onClick

object (OnClick)

L'azione onClick per questa attività.

CardFixedFooter

Un piè di pagina persistente (fisso) visualizzato nella parte inferiore della scheda.

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

Per le app di chat, puoi utilizzare i piè di pagina fissi nelle finestre di dialogo, ma non nei messaggi delle schede. Per un esempio nelle app Google Chat, vedi Piè di pagina della scheda.

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 colori impostati.

secondaryButton

object (Button)

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

DisplayStyle

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

Disponibili per i componenti aggiuntivi di Google Workspace e non 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 e copre parzialmente la scheda superiore corrente della pila. Se fai clic sull'intestazione, la scheda viene visualizzata nella pila di schede. Se la scheda non ha un'intestazione, viene utilizzata al suo posto un'intestazione generata.
REPLACE Valore predefinito. La scheda viene mostrata sostituendo la visualizzazione della scheda superiore nella pila di schede.