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 appaiono incorporati, proprio come scrivono le persone in Google Chat messaggi. 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 procedure in più fasi 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 .

Nel seguente Ad esempio, un'app di Chat crea un messaggio in uno spazio per un team di sviluppatori di software che si sta avvicinando 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 formato JSON restituisce il seguente messaggio:

SMS di esempio in Google Chat che comunica il blocco del codice.

Struttura di un messaggio di una scheda

Nell'API Google Chat, i messaggi sono rappresentati come oggetti JSON. All'interno di un messaggio una carta è rappresentata come cardsV2 ed è costituito da quanto segue:

  • Uno o più CardWithId oggetti.
  • 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 come titolo, sottotitolo e immagine in stile avatar.
    • Uno o più section oggetti che contengono almeno un widget.
    • Uno o più widget oggetti. Ogni widget è un oggetto composito che può rappresentare testo, immagini e altri tipi di oggetti.

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

Un&#39;app di Chat che esegue un sondaggio in una chat spazio con una scheda messaggio

Il seguente codice rappresenta il codice JSON del messaggio della carta:

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 Card Builder per progettare e visualizzare l'anteprima di messaggi delle schede JSON per le app di chat:

Apri il generatore di schede