Panoramica dei messaggi di Google Chat

Questa pagina spiega le differenze tra i messaggi di testo e quelli delle schede.

Quando le app di chat inviano messaggi per trasmettere informazioni di base, i messaggi vengono visualizzati in linea, proprio come scrivono le persone in Google Chat. Per creare messaggi che contengono più di un testo o per creare messaggi con cui gli utenti possono interagire, le app di chat possono utilizzare le schede. Le app di chat possono anche aggiungere un messaggio con una scheda. Per invitare gli utenti a completare procedure in più passaggi, ad esempio compilare un modulo, le app Chat possono anche creare schede che si aprono in una nuova finestra come finestre di dialogo.

Anatomia di un messaggio

Nell'API Google Chat, i messaggi sono rappresentati come oggetti JSON. All'interno di un messaggio, un messaggio è rappresentato come un oggetto text.

Nel seguente esempio, un'app di Chat crea un messaggio in uno spazio per informare un team di sviluppatori software che è imminente un blocco del codice:

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

Il JSON restituisce il seguente messaggio:

Esempio di messaggio in Google Chat che annuncia il blocco del codice.

Anatomia di un messaggio della scheda

Nell'API Google Chat, i messaggi sono rappresentati come oggetti JSON. All'interno di un messaggio, una scheda è rappresentata come un array cardsV2 e comprende quanto segue:

  • Uno o più oggetti CardWithId.
  • Un cardId, utilizzato per identificare la scheda e il relativo ambito all'interno di un determinato messaggio. Le schede in messaggi diversi possono avere lo stesso ID.

  • Un oggetto card, composto da quanto segue:

    • Un oggetto header che specifica elementi quali titolo, sottotitolo e immagine in stile avatar.
    • Uno o più oggetti section che contengono ciascuno almeno un widget.
    • Uno o più oggetti widget. Ogni widget è un oggetto composito che può rappresentare testo, immagini, pulsanti e altri tipi di oggetti.

Ad esempio, il seguente messaggio della scheda contiene gli oggetti header, section e widget:

Un&#39;app Chat che esegue un sondaggio in uno spazio Chat utilizzando un messaggio con scheda

Il seguente codice rappresenta il JSON del messaggio della scheda:

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

Utilizza lo strumento per la creazione di schede per progettare e visualizzare l'anteprima di interfacce utente e messaggistica per le app di chat:

Apri lo strumento per la creazione di schede