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:
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.
- Un oggetto
Ad esempio, il seguente messaggio della scheda contiene
header
,
section
e
widget
oggetti:
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