Google Chat vous permet d'appliquer une mise en forme aux messages, y compris grâce aux options suivantes:
- Mise en forme de base du texte (gras, italique et barré, par exemple) dans les messages et les messages sous forme de fiches
- Texte du lien :
- @mentionnez un ou tous les utilisateurs dans un espace Chat.
- Ajoutez des icônes intégrées et personnalisées uniquement dans les messages de fiche.
Mettre en forme un message
Chat vous permet d'ajouter une mise en forme de base à un message texte, y compris en gras, en italique et barré, en utilisant un petit sous-ensemble de la syntaxe Markdown. Vous mettez en forme le texte différemment dans les messages texte que dans les messages sous forme de fiche, car ils suivent la même syntaxe que les utilisateurs de Chat. Pour mettre en forme le texte qui apparaît dans une carte, consultez Mettre en forme un message sous forme de fiche.
Pour mettre en forme des messages texte, utilisez la syntaxe suivante:
Format | Symbole | Exemple de syntaxe | Texte affiché dans Google Chat |
---|---|---|---|
Gras | * | *bonjour* | bonjour |
Italique | _ (trait de soulignement) | _bonjour_ | bonjour |
Barré | ~ | ~bonjour~ | |
Police à chasse fixe | ` (guillemet oblique) | "bonjour" | hello |
Bloc à espace unique | ` ` ` (trois guillemets obliques) | ``` Hello World ``` |
Hello |
Liste à puces | * ou - (trait d'union) suivi d'un espace | * Il s'agit du premier élément de la liste. * Il s'agit du deuxième élément de la liste. |
|
Prenons l'exemple du code JSON suivant:
{
"text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
}
Ce message mis en forme affiche les éléments suivants dans un espace Chat:
Afficher la mise en forme du texte envoyé dans un message
Lorsqu'un utilisateur envoie un message, le corps en texte brut se trouve dans le champ text
. Une partie du formatage appliqué au message texte à l'aide de la syntaxe Markdown se trouve dans le champ text
. Une mise en forme supplémentaire est indiquée dans le champ formattedText
de sortie uniquement. Par exemple:
- Syntaxe Markdown supplémentaire pour le texte
- Mentions de l'utilisateur
- Liens hypertextes 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 l'UI Chat, le champ text
ne contient que le texte, tandis que le champ formattedText
contient les balisages, le texte et le lien hypertexte. L'exemple suivant montre le brouillon d'un message texte avec un mot sous forme de lien hypertexte, des éléments d'une liste et 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 du message, telle que http://www.example.com/
, Google Chat l'utilise comme texte du lien et renvoie automatiquement ce texte vers l'URL spécifiée.
Pour fournir un texte alternatif de votre lien, utilisez la syntaxe suivante:
Exemple de syntaxe | Texte affiché dans Google Chat |
---|---|
<https://example.com|Example website> |
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 Chat peuvent envoyer des SMS dans lesquels un ou tous les utilisateurs d'un espace Chat sont @mentionnés. Les applications Chat ne peuvent pas mentionner les utilisateurs d'un espace en mode importation ni ceux qui n'ont pas rejoint l'espace.
Mentionner des utilisateurs spécifiques
Pour mentionner un utilisateur spécifique avec @, ajoutez <users/{user}>
au message texte, où {user}
est l'ID de l'utilisateur. Prenons l'exemple du message texte suivant, 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 l'utilisateur, vous pouvez utiliser le champ
message.sender.name
de l'événement d'interactionMESSAGE
. Si votre application Google Chat crée un SMS asynchrone, vous pouvez spécifier la valeur de
users/{user}
comme suit:- Utilisez le champ
name
de la ressource Google ChatUser
, par exempleusers/123456789012345678901
. - Utilisez l'adresse e-mail de l'utilisateur comme alias pour la valeur
{user}
. Par exemple, si l'adresse e-mail estmahan@example.com
, vous pouvez spécifier l'utilisateur en tant queusers/mahan@example.com
. Pour utiliser un alias d'adresse e-mail, votre application Google Chat doit s'authentifier en tant qu'utilisateur.
- Utilisez le champ
Si vous utilisez l'API People, vous pouvez également utiliser la méthode
people.get
pour identifier l'ID utilisateur.
Mentionner tous les utilisateurs avec @
Pour créer un message texte @mentionnant tous les membres d'un espace, remplacez {user}
par 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 un message sous forme de fiche
À l'intérieur des fiches, la plupart des champs de texte sont compatibles avec la mise en forme de texte de base à l'aide d'un petit sous-ensemble de balises HTML. Vous mettez en forme le texte différemment dans les messages sous forme de fiche et dans les messages texte, car ils suivent la même syntaxe que les utilisateurs de Chat. Pour mettre en forme le texte d'un message, consultez Mettre en forme un message.
Utilisez Card Builder pour concevoir et prévisualiser les messages de fiche JSON pour les applications Chat:
Ouvrez l'outil de création de cartesLes balises compatibles et leur fonction sont présentées dans le tableau suivant:
Format | Exemple | Résultat affiché |
---|---|---|
Gras | "This is <b>bold</b>." |
Ce texte est en gras. |
Italique | "This is <i>italics</i>." |
C'est du caractère en italique. |
Underline | "This is <u>underline</u>." |
C'est le souligné. |
Barré | "This is <s>strikethrough</s>." |
Elle est |
Couleur de la police | "This is <font color=\"#FF0000\">red font</font>." |
Il s'agit d'une police rouge. |
Lien hypertexte | "This is a <a href=\"https://www.google.com\">hyperlink</a>." |
Ceci est un lien hypertexte. |
Durée | "This is a time format: <time>2023-02-16 15:00</time>." |
Il s'agit d'un format d'heure suivant: . |
Saut de ligne | "This is the first line. <br> This is a new line. pouces |
Ceci est la première ligne. Ceci est une nouvelle ligne. |
Ajouter une icône intégrée à une fiche
Les widgets DecoratedText
et ButtonList
sont compatibles avec l'élément icon
permettant de spécifier l'une des icônes intégrées disponibles dans Chat.
Le tableau suivant liste les icônes intégrées disponibles pour les messages avec fiche:
Avion | BOOKMARK | ||
BUS | VOITURE | ||
Horloge | CONFIRMATION_NUMBER_ICON | ||
DESCRIPTION | DOLLAR | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HÔTEL | HOTEL_ROOM_TYPE | ||
INVITATION | MAP_PIN | ||
SOUSCRIPTION | MULTIPLE_PEOPLE | ||
PERSONNE | TÉLÉPHONE | ||
RESTAURANT_ICON | SHOPPING_CART | ||
AJOUTER AUX FAVORIS | BOUTIQUE | ||
BILLET | TRAIN | ||
VIDEO_CAMERA | VIDEO_PLAY |
Voici un exemple de carte avec une icône d'e-mail:
Ajouter une icône Material Design Google à une fiche
Les widgets DecoratedText
et ButtonList
vous permettent d'utiliser les icônes Google Material. Vous pouvez ainsi choisir parmi plus de 2 500 options d'icônes et personnaliser l'épaisseur, le remplissage et le niveau des icônes.
Voici un exemple de fiche avec une icône Material de Google:
Ajouter une icône personnalisée à une fiche
Les widgets DecoratedText
et ButtonList
vous permettent d'utiliser les icônes intégrées ou de définir vos propres icônes personnalisées. Pour ajouter une icône personnalisée à une fiche, incluez le champ iconUrl
et spécifiez l'URL correspondante de l'icône.
Voici un exemple d'icône personnalisée: