Messages de format

Cette page explique comment les applications Google Chat peuvent mettre en forme le texte pour envoyer des messages contiennent l'un des éléments suivants:

• Texte enrichi contenant des liens hypertexte ou @mentionnant un ou tous les utilisateurs d'une Espace Chat.
• Texte qui apparaît dans une interface de carte, y compris sous forme de paragraphe ou Texte de l'interface utilisateur qui s'affiche à côté d'une icône, comme un bouton.

Mettre en forme un message

Chat vous permet d'appliquer une mise en forme de base à un message, y compris gras, italique et barré, en utilisant un petit sous-ensemble de la syntaxe Markdown. Toi formater le texte différemment dans les SMS et dans les messages de cartes, car les textes les messages sont formatés avec la même syntaxe que Chat les utilisateurs.

Pour mettre en forme des messages texte, utilisez la syntaxe suivante:

Prenons l'exemple du fichier JSON suivant:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Ce message texte mis en forme affiche le contenu suivant dans un chat espace:

Afficher la mise en forme du texte envoyé dans un message

Lorsqu'un utilisateur envoie un message, le corps du message en texte brut se trouve dans la text. Mise en forme appliquée au message texte à l'aide de Markdown dans le champ text. Vous trouverez des options de mise en forme supplémentaires dans les champ formattedText de sortie uniquement, y compris les suivants:

• Syntaxe Markdown supplémentaire pour le texte
• Mentions de l'utilisateur
• Liens hypertexte personnalisés
• Emoji personnalisés

Prenons l'exemple du texte suivant envoyé par un utilisateur:

Si le message a été mis en forme à l'aide du menu Format de la Chat, le champ text ne contient que du texte, tandis que le formattedText contient les balisages, le texte et le lien hypertexte. La L'exemple suivant montre le brouillon d'un message texte avec un mot sous forme de lien hypertexte, d'une liste avec un mot en gras:

Le message est reçu au format suivant:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Mettre en forme les liens

Si vous incluez une URL de lien brut dans le texte de votre message, par exemple http://www.example.com/, Google Chat l'utilise comme texte du lien et associe automatiquement ce texte à l'URL spécifiée.

Pour fournir un texte alternatif pour votre lien, utilisez la syntaxe suivante:

La barre verticale et le texte du lien sont facultatifs. Par conséquent, <https://www.example.com/> et https://www.example.com/ sont équivalents.

Mentionner des utilisateurs dans un message

Les applications de chat peuvent envoyer des sms qui @mentionnent un ou tous les utilisateurs d'un espace Chat. Les applications de chat ne peuvent pas mentionner les utilisateurs d'un un espace de stockage en mode importation ou tout utilisateur n'ont pas rejoint l'espace.

@mentionner des utilisateurs spécifiques

Pour @mentionner un utilisateur spécifique, ajoutez <users/{user}> au SMS où {user} est l'ID de l'utilisateur. Prenons l'exemple du texte suivant : message où 123456789012345678901 représente l'ID de l'utilisateur Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Le message s'affiche comme suit:

Vous pouvez spécifier la valeur users/{user} de différentes manières:

• Si votre application Google Chat répond à un message envoyé par le vous pouvez utiliser le champ message.sender.name de Événement d'interaction MESSAGE.

• Si votre application Google Chat crée un message texte asynchrone, vous pouvez spécifier la valeur de users/{user} comme suit:

  • Utiliser le champ name de Google Chat Ressource User, telle que users/123456789012345678901
  • Utilisez l'adresse e-mail de l'utilisateur comme alias pour la valeur {user}. Pour Par exemple, si l'adresse e-mail est mahan@example.com, vous pouvez spécifier l'utilisateur en tant que users/mahan@example.com. Pour utiliser un alias d'adresse e-mail, L'application Google Chat doit s'authentifier en tant qu'utilisateur.

• Si vous utilisez l'API People, vous pouvez également utiliser la Méthode people.get pour identifier l'ID utilisateur.

@mentionner tous les utilisateurs

Pour créer un SMS qui @mentionne tous les membres d'un espace, remplacez {user} avec all. L'exemple JSON suivant mentionne tous les utilisateurs dans un message:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Mettre en forme le texte qui s'affiche dans les cartes

À l’intérieur des cartes, la plupart des champs de texte prennent en charge la mise en forme de base du texte en utilisant un petit sous-ensemble de balises HTML. La mise en forme du texte est différente dans les messages de fiche et dans les messages car ils sont formatés avec la même syntaxe que Chat utilisé par les utilisateurs.

Utilisez Card Builder pour concevoir et prévisualiser la messagerie et les interfaces utilisateur des applications Chat:

Mettre en forme le texte du paragraphe

Les balises prises en charge et leur fonction sont présentées ci-dessous tableau:

Ajouter des icônes au texte

Pour afficher des icônes à côté du texte dans une fiche, vous pouvez utiliser les DecoratedText et ButtonList widgets.

Les sections suivantes expliquent comment utiliser les icônes intégrées, Google Material des icônes ou des icônes personnalisées dans du texte ou des boutons décorés.

Utiliser les icônes de Chat

Pour utiliser les icônes intégrées disponibles dans Chat, procédez comme suit : spécifiez l'un des éléments suivants:

Le tableau suivant répertorie les icônes intégrées disponibles pour les messages sous forme de fiches:

La Voici un exemple de carte avec une icône d'e-mail:

Utiliser les icônes Google Material

Vous pouvez utiliser des icônes Google Material. pour choisir parmi plus de 2 500 icônes et personnaliser le poids, le remplissage et le niveau des icônes.

Voici un exemple de carte avec une icône Google Material:

Utiliser des icônes personnalisées

Pour ajouter une icône personnalisée, incluez le champ iconUrl et spécifiez l'attribut de l'icône l'URL correspondante.

Voici un exemple d'icône personnalisée: