Concevoir les composants d'une carte ou d'une boîte de dialogue

Cette page explique comment concevoir et créer les principaux composants d'interface utilisateur des messages de fiche dans Google Chat.

Les fiches sont compatibles avec une mise en page définie, des éléments d'interface utilisateur interactifs tels que des boutons et des éléments rich media tels que des images. Elles vous permettent de présenter des informations, de recueillir des commentaires ou de fournir aux utilisateurs les étapes suivantes dans des messages et des boîtes de dialogue.

Utilisez Card Builder pour concevoir et prévisualiser les messages de fiche JSON pour les applications Chat:

Ouvrez l'outil de création de cartes

Les cartes et les boîtes de dialogue comportent généralement les composants suivants:

  • CardHeader contenant le titre de votre carte.
  • Un ou plusieurs widgets CardSection qui forment le corps principal de la fiche.
  • Widget CardFixedFooter spécifique aux boîtes de dialogue uniquement.

Prérequis

  • Un compte Google Workspace ayant accès à Google Chat
  • Une application Chat publiée. Pour créer une application Chat, suivez ce quickstart.

    • Ajouter un en-tête

    Le widget CardHeader représente l'en-tête d'une fiche. Les en-têtes peuvent inclure un titre, un sous-titre et une image d'avatar pour votre fiche.

    Vous pouvez inclure CardHeader pour les messages sous forme de fiches et les boîtes de dialogue.

    Voici un exemple de CardHeader:

    Définir une section d'une fiche

    Le widget CardSection est un conteneur de haut niveau dans une fiche. Les sections de fiches permettent de regrouper des widgets dans une fiche. Pour chaque section de fiche, vous pouvez inclure un en-tête et un ou plusieurs widgets.

    Vous pouvez inclure CardSection pour les messages sous forme de fiches et les boîtes de dialogue.

    Voici un exemple de CardSection contenant deux widgets textParagraph:

    Le widget CardFixedFooter représente le pied de page d'un message de boîte de dialogue envoyé par une application Chat. Les pieds de page peuvent inclure un bouton principal et un bouton secondaire.

    Le widget CardFixedFooter n'est disponible que pour les boîtes de dialogue.

    Voici un exemple de widget CardFixedFooter avec deux boutons:

    Résoudre les problèmes

    Lorsqu'une application ou une fiche Google Chat renvoie une erreur, l'interface Chat affiche un message indiquant "Une erreur s'est produite". ou "Impossible de traiter votre demande". Parfois, l'UI Chat n'affiche aucun message d'erreur, mais l'application ou la carte Chat produit un résultat inattendu. Par exemple, il est possible qu'un message de fiche ne s'affiche pas.

    Bien qu'aucun message d'erreur ne s'affiche dans l'UI Chat, des messages d'erreur descriptifs et des données de journal sont disponibles pour vous aider à corriger les erreurs lorsque la journalisation des erreurs est activée pour les applications Chat. Pour obtenir de l'aide sur l'affichage, le débogage et la correction des erreurs, consultez Résoudre les problèmes dans Google Chat.