Cette page explique les différences entre les messages texte et les messages par carte.
Lorsque les applications Chat envoient des SMS pour transmettre des informations de base, les messages s'affichent en ligne, de la même manière que les utilisateurs de Google Chat écrivent ; messages. Pour créer des messages contenant plus que du texte, ou pour créer messages avec lesquels les utilisateurs peuvent interagir, les applications Chat peuvent utiliser fiches. Les applications de chat peuvent également ajouter une fiche à un message. À inviter les utilisateurs à terminer des processus en plusieurs étapes comme remplir un formulaire, Les applications de chat peuvent également créer des fiches qui s'ouvrent dans une nouvelle fenêtre boîtes de dialogue.
Anatomie d'un message
Dans l'API Google Chat, les messages sont représentés sous forme d'objets JSON. Dans un message,
un message texte est représenté
text
.
Dans les Exemple : une application Chat crée un message dans un espace pour une équipe de développeurs logiciels qu'un gel de code approche:
{
"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."
}
JSON renvoie le message suivant:
Anatomie d'un message sous forme de fiche
Dans l'API Google Chat, les messages sont représentés sous forme d'objets JSON. Dans un message
une carte est représentée
cardsV2
et comprend les éléments suivants:
- Une ou plusieurs
Objets
CardWithId
. cardId
, utilisé pour identifier la carte et être limité à un message donné. (Les fiches figurant dans différents messages peuvent avoir le même ID.)Un objet
card
comprenant les éléments suivants:- Un objet
header
qui spécifie des choses comme un titre, un sous-titre et une image de style avatar. - Une ou plusieurs
Objets
section
contenant chacun au moins un widget. - Une ou plusieurs
Objets
widget
. Chaque widget est un objet composite pouvant représenter du texte, des images, des boutons et d'autres types d'objets.
- Un objet
Par exemple, le message de fiche suivant contient
header
,
section
Objets widget
:
Le code suivant représente le fichier JSON du message de la carte:
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": "[email protected]"
}
},
{
"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"
}
]
}
}
}
]
}
}
]
}
]
}
}
]
}
Utilisez le générateur de cartes pour concevoir et prévisualiser des messages de cartes JSON pour les applications Chat:
Ouvrir Card Builder