In questa pagina vengono spiegate le differenze tra SMS e messaggi con scheda.
Quando le app di chat inviano messaggi per trasmettere informazioni di base, i messaggi appaiono in linea, proprio come le persone in Google Chat scrivono i messaggi. Per creare messaggi contenenti 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 consentono anche di aggiungere un messaggio con una scheda. Per chiedere agli utenti di completare processi in più passaggi come la compilazione di un modulo, le app di 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 SMS è rappresentato come un oggetto text
.
Nel seguente esempio, un'app di chat crea un messaggio in uno spazio per un team di sviluppatori di software che si sta avvicinando al 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:
Struttura di un messaggio di scheda
Nell'API Google Chat, i messaggi sono rappresentati come oggetti JSON. All'interno di un messaggio, una scheda è rappresentata come un array cardsV2
ed è composta da quanto segue:
- Uno o più oggetti
CardWithId
. - Un
cardId
, utilizzato per identificare la scheda e l'ambito di un determinato messaggio. Le schede in messaggi diversi possono avere lo stesso ID. Un oggetto
card
, costituito da quanto segue:- Un oggetto
header
che specifica elementi come un titolo, un sottotitolo e un'immagine in stile avatar. - Uno o più oggetti
section
, ciascuno contenente almeno un widget. - Uno o più oggetti
widget
. Ogni widget è un oggetto composito che può rappresentare testo, immagini, pulsanti e altri tipi di oggetti.
- Un oggetto
Ad esempio, il seguente messaggio della scheda contiene oggetti header
, section
e widget
:
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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
Progetta e visualizza l'anteprima delle schede con Card Builder.
Apri Card Builder