Package google.apps.card.v1

Indice

Azione

Un'azione che descrive il comportamento quando viene inviato il modulo. Ad esempio, puoi richiamare uno script 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.

Campi
function

string

Una funzione personalizzata da richiamare quando l'elemento contenitore viene selezionato o attivato in altro modo.

Ad esempio, vedi Leggere i dati dei moduli.
parameters[]

ActionParameter

Elenco dei parametri di azione.
loadIndicator

LoadIndicator

Specifica l'indicatore di caricamento che l'azione mostra mentre si fa l'invito all'azione.
persistValues

bool

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

Interaction

Campo facoltativo. Obbligatorio all'apertura di 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'istruzione action, ad esempio aprendo un link o eseguendo 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, non viene mostrato alcun 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 per 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ù, visita la pagina CommonEventObject.

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

Campi
key

string

Il nome del parametro per l'action script.
value

string

Il valore del parametro.

Interazione

Campo facoltativo. Obbligatorio all'apertura di 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'istruzione action, ad esempio aprendo un link o eseguendo 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, non viene mostrato alcun 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 per i componenti aggiuntivi di Google Workspace.

Enum
INTERACTION_UNSPECIFIED Valore predefinito. L'istanza action viene eseguita normalmente.
OPEN_DIALOG

Apre una finestra di dialogo, un'interfaccia basata su schede e finestra che le app di chat utilizzano per interagire con gli utenti.

Supportata solo dalle app di chat in risposta ai clic sui pulsanti nei messaggi delle schede. 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 per i componenti aggiuntivi di Google Workspace.

LoadIndicator

Specifica l'indicatore di caricamento che l'azione mostra mentre si fa l'invito all'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.

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.

Campi
type

BorderType

Il tipo di bordo.
strokeColor

Color

I colori da utilizzare quando il tipo è BORDER_TYPE_STROKE.
cornerRadius

int32

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. Senza bordo.
STROKE Outline.

Pulsante

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

Per trasformare l'immagine in un pulsante cliccabile, specifica un valore Image (non ImageComponent) e imposta un'azione onClick.

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

Campi
text

string

Il testo visualizzato all'interno del pulsante.
icon

Icon

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

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 quello di sfondo. Ad esempio, se imposti uno sfondo blu, è probabile che il testo sia bianco.

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

Per il rosso, il verde e il blu, il valore di ciascun campo è un numero float che puoi esprimere in due modi: come 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 presenza completa di quel colore sulla scala RGB.

Facoltativamente, imposta alpha, che consente di impostare 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 in tinta unita, mentre il valore 0 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

OnClick

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

bool

Se true, il pulsante viene visualizzato in stato inattivo 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 va alla documentazione per gli sviluppatori di Google Chat all'indirizzo https://developers.google.com/workspace/chat".

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.

Campi
buttons[]

Button

Una serie di pulsanti.

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 dell'interfaccia utente interattivi come i pulsanti e contenuti rich media come le immagini. Utilizza le schede per presentare informazioni dettagliate, raccogliere informazioni dagli utenti e guidarli nel passaggio successivo.

Progettare e visualizzare l'anteprima delle schede con il generatore di schede.

Apri il generatore di schede

Per scoprire come creare schede, consulta la seguente documentazione:

Esempio: messaggio nella scheda per un'app Google Chat

Scheda contatto di esempio

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": "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"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}
Campi
header

CardHeader

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

Section

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

DividerStyle

Lo stile del divisore tra le sezioni.
cardActions[]

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 per le app Google Chat.

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

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

CardFixedFooter

Il piè di pagina fisso mostrato in fondo a questa scheda.

L'impostazione di fixedFooter senza specificare un primaryButton o un 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

DisplayStyle

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

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

CardHeader

Quando vengono visualizzati contenuti contestuali, l'intestazione della scheda popup funge da segnaposto per consentire all'utente di spostarsi tra le schede della home page e quelle contestuali.

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

CardAction

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

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

Campi
actionLabel

string

L'etichetta visualizzata come voce del menu azione.
onClick

OnClick

L'azione onClick per questa attività.

CardFixedFooter

Un piè di pagina permanente (persistente) 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 piè di pagina fissi nelle finestre di dialogo, ma non nei messaggi delle schede. Per un esempio nelle app Google Chat, vedi Aggiungere un piè di pagina permanente.

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

Campi
primaryButton

Button

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

Button

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

CardHeader

Rappresenta l'intestazione di una 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.

Campi
title

string

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

string

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

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

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 e copre parzialmente l'attuale scheda superiore della pila. 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 mostrata sostituendo la visualizzazione della scheda in alto nella pila di schede.

DividerStyle

Lo stile di divisore di una scheda. 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. Crea un separatore solido tra le sezioni.
NO_DIVIDER Se impostato, non viene visualizzato alcun divisore tra le sezioni.

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.

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[]

Widget

Tutti i widget della sezione. Deve contenere almeno un widget.
collapsible

bool

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

int32

Il numero di widget non comprimibili che rimangono visibili anche quando una sezione viene 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. Il uncollapsibleWidgetsCount viene preso in considerazione solo quando collapsible è true.

Colonne

Il widget Columns mostra fino a due colonne in una scheda o in una finestra di dialogo. Puoi aggiungere widget a ciascuna 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 le colonne avranno l'altezza della prima colonna. Poiché ogni colonna può contenere un numero diverso di widget, non puoi definire righe o allineare widget tra le colonne.

Le colonne vengono visualizzate una accanto all'altra. Puoi personalizzare la larghezza di ogni colonna utilizzando il campo HorizontalSizeStyle. Se la larghezza dello schermo dell'utente è troppo ridotta, la seconda colonna 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 punti.
  • 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.

Campi
columnItems[]

Column

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

Colonna

Una colonna.

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

Campi
horizontalSizeStyle

HorizontalSizeStyle

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

HorizontalAlignment

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

VerticalAlignment

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

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 all'interno della colonna.

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

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 riempie la quantità minore di spazio possibile e non più del 30% della larghezza della scheda.

VerticalAlignment

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

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

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.

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

Campi

Campo unione data.

data può essere solo uno dei seguenti:
textParagraph

TextParagraph

TextParagraph widget.
image

Image

Image widget.
decoratedText

DecoratedText

DecoratedText widget.
buttonList

ButtonList

ButtonList widget.
textInput

TextInput

TextInput widget.
selectionInput

SelectionInput

SelectionInput widget.
dateTimePicker

DateTimePicker

DateTimePicker widget.

DateTimePicker

Consente agli utenti di inserire una data, un'ora oppure una data e un'ora. Per un esempio nelle app Google Chat, vedi Consentire all'utente di scegliere una data e un'ora.

Gli utenti possono inserire 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 correttamente le informazioni.

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

Campi
name

string

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

Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i 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 stanno fissando un appuntamento, utilizza un'etichetta come Appointment date o Appointment date and time.
type

DateTimePickerType

Se il widget supporta l'inserimento di data, ora o data e ora.
valueMsEpoch

int64

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: data e ora di calendario nel fuso orario UTC. Ad esempio, per indicare il 1° gennaio 2023 alle 12:00 UTC, utilizza 1672574400000.
  • DATE_ONLY: una data di calendario alle ore 00:00:00 UTC. Ad esempio, per rappresentare il 1° gennaio 2023, utilizza 1672531200000.
  • TIME_ONLY: un'ora nel fuso orario UTC. Ad esempio, per rappresentare le 12:00, utilizza 43200000 (o 12 * 60 * 60 * 1000).
timezoneOffsetDate

int32

Il numero che rappresenta la differenza di fuso orario rispetto al fuso orario UTC, espressa in minuti. Se impostato, value_ms_epoch viene visualizzato nel fuso orario specificato. Se non viene configurato, il valore predefinito corrisponde all'impostazione del fuso orario dell'utente.
onChangeAction

Action

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

DateTimePickerType

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

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 hanno inserito una data.
TIME_ONLY Gli utenti inseriscono un orario.

DecoratedText

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

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

Campi
icon
(deprecated)

Icon

Obsoleto a favore di startIcon.
startIcon

Icon

Icona visualizzata davanti al testo.
topLabel

string

Il testo visualizzato sopra text. Tronca sempre.
text

string

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

bool

L'impostazione del testo a capo. Se true, il testo viene a capo e 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. Confezione sempre disponibile.
onClick

OnClick

Questa azione viene attivata quando gli utenti fanno clic su topLabel o bottomLabel.
Campo unione control. Un pulsante, un sensore, una casella di controllo o un'immagine visualizzati a destra del testo nel widget decoratedText. control può essere solo uno dei seguenti:
button

Button

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

SwitchControl

Un widget di cambio su cui un utente può fare clic per modificare il proprio stato e attivare un'azione.
endIcon

Icon

Icona visualizzata dopo il testo.

Supporta icone integrate e personalizzate.

SwitchControl

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.

Campi
name

string

Il nome con cui viene identificato il widget di cambio in un evento di input del 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 maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
selected

bool

Quando l'opzione true è selezionata.
onChangeAction

Action

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

ControlType

Come viene visualizzata l'opzione nell'interfaccia utente.

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

ControlType

Come viene visualizzata l'opzione nell'interfaccia utente.

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

Enum
SWITCH Un interruttore.
CHECKBOX Obsoleto a favore di CHECK_BOX.
CHECK_BOX Una casella di controllo.

Divisore

Questo tipo non contiene campi.

Visualizza un divisore tra i widget come una 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": {}

EndNavigation

Azione del flusso della finestra di dialogo.

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

Campi
action

Action

L'azione di rendering che consente al client di terminare un flusso di finestre di dialogo.

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

Azione

I tipi di azione di rendering che consentono al client di terminare un flusso di finestre di dialogo.

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

Enum
ACTION_UNSPECIFIED Azione non specificata.
CLOSE_DIALOG Chiudi la finestra di dialogo.
CLOSE_DIALOG_AND_EXECUTE Chiudi la procedura e aggiorna la scheda che l'ha aperta.

GetAutocompletionResponse

Una risposta all'ottenimento del contenitore di completamento automatico, che include gli elementi necessari per mostrare gli elementi con completamento automatico per il campo di testo.

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

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}
Campi
autoComplete

Suggestions
schema

string

Si tratta di un campo dello schema autonomo che potrebbe essere presente nel markup per il controllo della sintassi.

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, vedi 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"
    }
  }
}
Campi
title

string

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

GridItem

Gli elementi da visualizzare nella griglia.
borderStyle

BorderStyle

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

int32

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

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.

Campi
id

string

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

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

GridItemLayout

Il layout da utilizzare per l'elemento della griglia.

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.

Icona

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

Supporta icone integrate e personalizzate.

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

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

Se l'icona è impostata su Button, la 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

ImageType

Lo stile di ritaglio applicato all'immagine. In alcuni casi, l'applicazione di un ritaglio CIRCLE causa la visualizzazione dell'immagine in una dimensione più grande rispetto a un'icona integrata.
Campo unione icons. L'icona visualizzata nel widget della 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 le icone integrate.
iconUrl

string

Visualizza 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 sono .png e .jpg.
materialIcon

MaterialIcon

Mostrare una delle icone dei materiali 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 per i componenti aggiuntivi di Google Workspace.

Immagine

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

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

Campi
imageUrl

string

L'URL HTTPS che ospita l'immagine.

Ad esempio:

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

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

ImageComponent

Rappresenta un'immagine.

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

Campi
imageUri

string

L'URL dell'immagine.
altText

string

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

ImageCropStyle

Lo stile di ritaglio da applicare all'immagine.
borderStyle

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
}
Campi
type

ImageCropType

Il tipo di ritaglio.
aspectRatio

double

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.

LinkPreview

Azione della scheda che mostra l'anteprima di un link di terze parti mostrando una scheda e uno smart chip. Per scoprire di più, consulta Visualizzare l'anteprima dei link con smart chip.

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

Ad esempio, il seguente JSON restituisce un titolo univoco per l'anteprima del link e il relativo smart chip, nonché una scheda di anteprima con un'intestazione e una descrizione testuale:

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

L'esempio restituisce la seguente anteprima del link:

Anteprima link di esempio

Campi
previewCard

Card

Una scheda che mostra informazioni su un link di un servizio di terze parti.
title

string

Il titolo che viene visualizzato nello smart chip per l'anteprima del link. Se il criterio non viene configurato, lo smart chip mostra l'intestazione di preview_card.
linkPreviewTitle

string

Il titolo che viene visualizzato nell'anteprima del link. Se il criterio non viene configurato, l'anteprima del link mostra l'intestazione del preview_card.

MaterialIcon

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

Ad esempio, per visualizzare un'icona a forma 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 per i componenti aggiuntivi di Google Workspace.

Campi
name

string

Il nome dell'icona definito nell'icona dei materiali di Google, ad esempio check_box. I nomi non validi vengono abbandonati e sostituiti con una stringa vuota, con la quale l'icona non viene visualizzata.
fill

bool

Indica se l'icona viene visualizzata come piena. Il valore predefinito è false.

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

int32

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 quello predefinito.

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

int32

Il peso e la pendenza influiscono sullo spessore di un simbolo. Le modifiche al grado sono più granulari di quelle al peso e hanno un piccolo impatto sulle dimensioni del simbolo. Scegli un'opzione tra {-25, 0, 200}. Se non è presente, il valore predefinito è 0. Se viene specificato qualsiasi altro valore, viene utilizzato quello predefinito.

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

Azione della scheda che manipola la pila di schede.

Ad esempio:

1) 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
  }

2) Aggiorna la carta sopra la pila (aggiornamento in posizione).

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

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) Torna indietro di un passaggio senza eseguire l'aggiornamento.

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

  navigations : {
    popCard : true,
  }

4) Torna indietro di più passaggi e aggiorna la carta.

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

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) Torna indietro di più passaggi per un valore CARD_NAME definito.

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

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) Torna alla directory principale e aggiorna la scheda.

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

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) Vai alla scheda specificata e apri anche quella.

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

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) Sostituisci la carta principale con una nuova. 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:
popToRoot

bool

La pila di schede fa emergere tutte le schede tranne la scheda principale.
pop

bool

La pila di schede fa emergere una scheda.
popToCard

string

La pila di schede mostra tutte le schede sopra la scheda specificata con il nome della scheda specificato.
pushCard

Card

Pila di carte spinge una carta sulla pila di carte.
updateCard

Card

La pila di schede aggiorna la scheda principale con una nuova scheda e conserva i valori dei campi compilati. Per un campo non equivalente, il valore viene eliminato.
endNavigation

EndNavigation

Azione di navigazione di fine flusso di dialogo. Per ulteriori informazioni, vedi Rispondere a una finestra di dialogo per i messaggi della home page dell'app

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

Notifica

Azione della scheda che mostra una notifica nell'app host.

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

Campi
text

string

Testo normale da visualizzare per la notifica, senza tag HTML.

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.

Campi

Campo unione data.

data può essere solo uno dei seguenti:
action

Action

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

Action

Un componente aggiuntivo attiva questa azione quando l'azione deve aprire un link. La differenza rispetto alla open_link riportata sopra dipende dal fatto che deve comunicare con il server per ottenere il link. Di conseguenza, il client web deve svolgere un'attività di preparazione prima che venga restituita la risposta all'azione sul link aperto.

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

Card

Una nuova scheda viene inserita nella pila di schede dopo aver fatto clic, se specificato.

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

OnClose

Cosa fa il 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 per le app Google Chat.

Enum
NOTHING Valore predefinito. La carta non si ricarica e non succede nulla.
RELOAD

Ricarica la scheda alla chiusura della finestra secondaria.

Se utilizzata insieme a OpenAs.OVERLAY, la finestra secondaria funge da finestra di dialogo modale e la scheda principale viene bloccata fino alla chiusura di quella secondaria.

OpenAs

Quando un'azione OnClick apre un link, il client può aprirlo come 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 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 come una finestra a grandezza originale (se questo è il frame utilizzato dal client).
OVERLAY Il link si apre come overlay, ad esempio popup.

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
hostAppAction

HostAppActionMarkup

Azioni gestite dalle singole app host.
schema

string

Si tratta di un campo dello schema autonomo che potrebbe essere presente nel markup per il controllo della sintassi.

Azione

Campi
navigations[]

Navigation

Inviare, mostrare o aggiornare le schede visualizzate.
notification

Notification

Mostra una notifica all'utente finale.
linkPreview

LinkPreview

Mostra un'anteprima del link all'utente finale.

SelectionInput

Un widget che crea uno o più elementi UI selezionabili dagli utenti. 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, vedi Aggiungere elementi dell'UI selezionabili.

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

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

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

Campi
name

string

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

SelectionType

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

SelectionItem

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

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 nei moduli, vedi Ricevere i dati dei moduli.
multiSelectMaxSelectedItems

int32

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

int32

Per i menu a selezione multipla, il numero di caratteri di testo inseriti da un utente prima che l'app esegua una query per il completamento automatico e mostra gli elementi suggeriti nel menu.

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

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

Disponibile per le app Google Chat e per i componenti aggiuntivi di Google Workspace. multi_select_data_source può essere solo uno dei seguenti:
externalDataSource

Action

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

PlatformDataSource

Un'origine dati di Google Workspace.

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 per i componenti aggiuntivi di Google Workspace.

Campi
Campo unione data_source. L'origine dati. data_source può essere solo uno dei seguenti:
commonDataSource

CommonDataSource

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

HostAppDataSourceMarkup

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

CommonDataSource

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

Disponibile per le app Google Chat e 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 sua organizzazione Google Workspace.

SelectionItem

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

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

Campi
text

string

Il testo che identifica o descrive l'articolo agli utenti.
value

string

Il valore associato a questo elemento. Il cliente dovrebbe utilizzarlo come valore di input del modulo.

Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
selected

bool

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 per un menu a discesa), imposta questo campo solo per un elemento.
startIconUri

string

Per i menu a selezione multipla, l'URL dell'icona visualizzato accanto al campo text dell'elemento. Supporta 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 testuale o un'etichetta visualizzata sotto il campo text dell'elemento.

SelectionType

Il formato degli elementi che gli utenti possono selezionare. Opzioni diverse 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 Una serie di caselle di controllo. Gli utenti possono selezionare una o più caselle di controllo.
RADIO_BUTTON Una serie di pulsanti di opzione. Gli utenti possono selezionare un solo 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 possono selezionare una o più voci. Gli utenti possono anche inserire valori per compilare i dati dinamici. Ad esempio, gli utenti possono iniziare a digitare il nome di uno spazio di Google Chat e il widget suggerirà automaticamente lo spazio.

Per compilare gli elementi di 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, 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, consulta Aggiungere un menu a selezione multipla.

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 gli sviluppatori.

SubmitFormResponse

Una risposta all'invio di un modulo che non sia recuperare un contenitore di completamento automatico, che contiene le azioni che la scheda deve eseguire e/o l'app host del componente aggiuntivo e se lo stato della scheda è cambiato.

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

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: salam.heba@example.com"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}
Campi
renderActions

RenderActions

Un insieme di istruzioni di rendering che indicano alla scheda di eseguire un'azione e/o all'app host del componente aggiuntivo di eseguire un'azione specifica per l'app.
stateChanged

bool

Se lo stato delle schede è cambiato e i dati nelle schede esistenti sono obsoleti.
schema

string

Si tratta di un campo dello schema autonomo che potrebbe essere presente nel markup per il controllo della sintassi.

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 si fa riferimento a JavaScript, alcuni utenti potrebbero inserire javascript e altri java script. Suggerendo che JavaScript possa standardizzare il modo in cui gli utenti interagiscono con la tua app.

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

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

Campi
items[]

SuggestionItem

Un elenco di suggerimenti utilizzati per i suggerimenti 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.

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. Equivale ai dati inseriti dagli utenti.

TextInput

Un campo in cui gli utenti possono inserire 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 immissione modulo. Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.

Quando hai bisogno di 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.

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 nei moduli, vedi Ricevere i dati dei moduli.
label

string

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

Specifica il 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 del cognome di una persona, scrivi surname anziché name.

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

string

Testo visualizzato sotto il campo di immissione testo per assistere gli utenti chiedendo loro di 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 modulo.

Per maggiori dettagli sull'utilizzo degli input nei moduli, vedi Ricevere i dati dei moduli.
type

Type

Come viene visualizzato un campo di immissione di testo nell'interfaccia utente. ad esempio se il campo è a una o più righe.
onChangeAction

Action

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

Alcuni esempi di azioni da eseguire sono l'esecuzione di una funzione personalizzata o l'apertura di una finestra di dialogo in Google Chat.
initialSuggestions

Suggestions

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 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 che JavaScript possa standardizzare il modo in cui gli utenti interagiscono con la tua app.

Se specificato, il valore 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

Action

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

Se non specificati, i suggerimenti vengono 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.

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

string

Testo visualizzato nel campo di immissione testo quando questo è 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 per i componenti aggiuntivi di Google Workspace.

Tipo

Come viene visualizzato un campo di immissione di testo nell'interfaccia utente. Ad esempio, che si tratti di un campo di immissione a riga singola o su più righe. Se initialSuggestions viene specificato, il valore di 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 di più righe.

TextParagraph

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

Campi
text

string

Il testo visualizzato nel widget.

Widget

Ogni scheda è composta da widget.

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

Campi
horizontalAlignment

HorizontalAlignment

Specifica se i widget sono 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

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 seguente JSON crea un testo in grassetto:

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

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

DecoratedText

Consente di mostrare un elemento di testo decorato.

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

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

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,
        "alpha": 1
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}
textInput

TextInput

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

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

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

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

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

Divider

Visualizza una linea orizzontale di divisione tra i widget.

Ad esempio, il seguente JSON crea un divisore:

"divider": {
}
grid

Grid

Visualizza una griglia con una raccolta di elementi.

Una griglia supporta un numero illimitato di colonne ed elementi. Il numero di righe è determinato dai limiti superiori del numero di elementi divisi 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 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

Columns

Visualizza fino a due colonne.

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

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

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

HorizontalAlignment

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

Disponibile per le app Google Chat e 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, 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, i widget vengono allineati a destra. Per i layout da destra a sinistra, i widget vengono allineati a sinistra.

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.