Panoramica dei messaggi di Google Chat

In questa pagina vengono spiegate le differenze tra i messaggi di testo e i messaggi a schede.

Quando le app di chat inviano messaggi per comunicare informazioni di base, i messaggi vengono visualizzati in linea, proprio come scrivono le persone in Google Chat. Per creare messaggi che contengono più di testo o per creare messaggi con cui gli utenti possono interagire, le app di chat possono schede. Le app di chat possono anche aggiungere un messaggio di testo con una scheda. A richiedere agli utenti di completare processi in più fase come la compilazione di un modulo, Le app di chat possono anche creare schede che si aprono in una nuova finestra di dialogo.

Struttura di un messaggio di testo

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

Nell'esempio seguente, un'app di Chat crea un messaggio in uno spazio per un team di sviluppatori software per segnalare l'imminente 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:

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 limitare l'ambito a un determinato messaggio. (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 e altri tipi di oggetti.

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

Il seguente codice rappresenta il JSON del messaggio della scheda:

{
  "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:

Argomenti correlati

• Invia un messaggio
• Formattare i messaggi