Progettare i componenti di una scheda o di una finestra di dialogo

In questa pagina viene descritto come progettare e creare i componenti principali dell'interfaccia utente della scheda messaggi in Google Chat.

Le schede supportano un layout definito, elementi interattivi dell'interfaccia utente, come pulsanti rich media come immagini. Puoi utilizzare le schede per presentare informazioni, raccogliere input, o indicare i passaggi successivi agli utenti tramite messaggi card e finestre di dialogo.

Utilizza Card Builder per progettare e visualizzare l'anteprima di messaggi delle schede JSON per le app di chat:

Apri il generatore di schede

In genere le schede e le finestre di dialogo includono i seguenti componenti:

  • Un CardHeader che contiene il titolo della tua carta.
  • Uno o più widget CardSection che costituiscono il corpo principale della scheda.
  • Un widget CardFixedFooter specifico solo per le finestre di dialogo.

Prerequisiti

  • Un account Google Workspace. con accesso a Google Chat.
  • Un'app di Chat pubblicata. Per creare un App Chat, segui questa guida rapida.

    • Aggiungi un'intestazione

    Il widget CardHeader che rappresenta l'intestazione di una scheda. Le intestazioni possono includere un titolo, sottotitolo e immagine avatar per la tua scheda.

    Puoi includere CardHeader per messaggi della scheda e finestre di dialogo.

    Di seguito è riportato un esempio di CardHeader:

    Definisci una sezione di una scheda

    Il widget CardSection è una un contenitore di alto livello all'interno di una scheda. Utilizzi la carta per raggruppare i widget all'interno di una scheda. Per ogni sezione della scheda, puoi includere un'intestazione e uno o più widget.

    Puoi includere CardSection per messaggi della scheda e finestre di dialogo.

    Di seguito è riportato un esempio di CardSection che contiene due textParagraph widget:

    La CardFixedFooter rappresenta il piè di pagina di un messaggio della finestra di dialogo inviato un'app di Chat. I piè di pagina possono includere un pulsante principale e un pulsante secondario.

    Il widget CardFixedFooter è disponibile solo per finestre di dialogo.

    Di seguito è riportato un esempio di widget CardFixedFooter con due pulsanti:

    Risoluzione dei problemi

    Quando un'app Google Chat o card restituisce un errore, L'interfaccia di Chat mostra il messaggio "Si è verificato un problema". o "Impossibile elaborare la richiesta". A volte, l'UI di Chat non mostra alcun messaggio di errore, ma l'app Chat o la scheda restituisce un risultato inaspettato; Ad esempio, il messaggio di una scheda potrebbe non vengono visualizzate.

    Anche se un messaggio di errore potrebbe non essere visualizzato nella UI di Chat, messaggi di errore descrittivi e dati di log che ti aiuteranno a correggere gli errori quando il logging degli errori per le app di chat è attivo. Per assistenza con la visualizzazione, il debug e la correzione degli errori, consulta Risolvere i problemi e correggere gli errori di Google Chat.