Présentation des messages Google Chat

Cette page explique les différences entre les messages sous forme de SMS et ceux sous forme de fiches.

Lorsque les applications Chat envoient des messages pour transmettre des informations de base, ceux-ci apparaissent de manière intégrée, de la même manière que les utilisateurs de Google Chat écrivent des messages. Pour créer des messages contenant plus que du texte ou pour créer des messages avec lesquels les utilisateurs peuvent interagir, les applications Chat peuvent utiliser des fiches. Les applications de chat peuvent également ajouter une fiche à un SMS. Pour inviter les utilisateurs à terminer des processus en plusieurs étapes, tels que le remplissage d'un formulaire, les applications Chat peuvent également créer des fiches qui s'ouvrent dans une nouvelle fenêtre sous forme de boîtes de dialogue.

Anatomie d'un message texte

Dans l'API Google Chat, les messages sont représentés par des objets JSON. Dans un message, il est représenté par un objet text.

Dans l'exemple suivant, une application Chat crée un message texte dans un espace destiné à une équipe de développeurs logiciels qui est sur le point de figer du code:

{
  "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."
}

Le fichier JSON renvoie le message suivant:

Anatomie d'un message sous forme de fiche

Dans l'API Google Chat, les messages sont représentés par des objets JSON. Dans un message, une carte est représentée sous la forme d'un tableau cardsV2 et comprend les éléments suivants:

• Un ou plusieurs objets CardWithId
• Un cardId, utilisé pour identifier la carte et limité à un message donné. (Les fiches de différents messages peuvent avoir le même identifiant.)

• Un objet card comprenant les éléments suivants:

  • Un objet header qui spécifie des éléments tels qu'un titre, un sous-titre et une image de style avatar.
  • Un ou plusieurs objets section contenant chacun au moins un widget.
  • Un ou plusieurs objets widget Chaque widget est un objet composite qui peut représenter du texte, des images, des boutons et d'autres types d'objets.

Par exemple, le message de carte suivant contient des objets header, section et widget:

Le code suivant représente le fichier JSON du message de la carte:

{
  "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"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Créez et prévisualisez des fiches avec Card Builder.

Articles associés

• Envoyer un message
• Mettre en forme des messages