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 sous forme de fiches 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. Vous pouvez utiliser des fiches pour présenter des informations, recueillir des données ou indiquer les prochaines étapes aux utilisateurs via des cartes et des boîtes de dialogue.

Utilisez le générateur de cartes pour concevoir et prévisualiser des messages de cartes JSON pour les applications Chat:

Ouvrir Card Builder

Les cartes et les boîtes de dialogue se composent généralement des éléments suivants:

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

Conditions préalables

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

    • Ajouter un en-tête

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

    Vous pouvez inclure CardHeader pour les messages de cartes 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 carte. Les sections de fiches vous permettent de regrouper les widgets au sein d'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 de cartes 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 le message "Une erreur s'est produite". ou "Impossible de traiter votre demande." Parfois, l'UI Chat n'affiche aucun message d'erreur, mais que l'application ou la fiche Chat produit un résultat inattendu (par exemple, un message de fiche ne s'affiche pas).

    Même s'il est possible qu'un message d'erreur ne s'affiche pas dans l'interface utilisateur de Chat, des messages d'erreur descriptifs et des données de journaux 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 concernant l'affichage, le débogage et la correction des erreurs, consultez Dépanner et corriger les erreurs dans Google Chat.