Google Chat vous permet de mettre en forme les messages, y compris pour:
- Les options de mise en forme de base (gras, italique et barré, par exemple) dans messages et messages sous forme de fiches.
- Texte du lien :
- @mentionner un ou tous les utilisateurs dans un espace Chat.
- Ajouter une configuration intégrée et Icônes personnalisées dans les messages sous forme de fiches uniquement.
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 le texte qui apparaît dans une carte, consultez Mettez 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) | _hello_ | bonjour |
Barré | ~ | ~bonjour~ | |
Police à chasse fixe | ` (guillemet arrière) | "bonjour" | hello |
Bloc à espace simple | ` ` ` (trois guillemets arrière) | ``` 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 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:
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 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 dans lequel 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'interactionMESSAGE
. 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 RessourceUser
, telle queusers/123456789012345678901
- Utilisez l'adresse e-mail de l'utilisateur comme alias pour la valeur
{user}
. Pour 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, L'application Google Chat doit s'authentifier en tant qu'utilisateur.
- Utiliser 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
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 un message sous forme de fiche
À 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. Pour mettre en forme le texte qui apparaît dans un message, voir Mettre en forme un message
Utilisez le générateur de cartes pour concevoir et prévisualiser des messages de cartes JSON pour les applications Chat:
Ouvrir Card BuilderLes balises prises en charge et leur fonction sont indiquées ci-dessous tableau:
Format | Exemple | Résultat affiché |
---|---|---|
Gras | "This is <b>bold</b>." |
Ce texte est en gras. |
Italique | "This is <i>italics</i>." |
Ceci est en italique. |
Souligné | "This is <u>underline</u>." |
C'est du texte souligner. |
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. |
Heure | "This is a time format: <time>2023-02-16 15:00</time>." |
Il s'agit du format d'heure suivant: . |
Retour à la 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 carte
La
DecoratedText
et
ButtonList
Les widgets sont compatibles avec l'élément icon
utilisée pour spécifier l'une des icônes intégrées disponibles dans Chat.
Le tableau suivant répertorie les icônes intégrées disponibles pour les messages sous forme de fiches:
Avion | Favori | ||
BUS | VOITURE | ||
Horloge | CONFIRMATION_NUMBER_ICON | ||
DESCRIPTION | DEVISE | ||
EVENT_SEAT | |||
FLIGHT_ARRIVAL | FLIGHT_DEPARTURE | ||
HÔTEL | HOTEL_ROOM_TYPE | ||
INVITE | MAP_PIN | ||
SOUSCRIPTION | MULTIPLE_PEOPLE | ||
PERSONNE | TÉLÉPHONE | ||
RESTAURANT_ICON | SHOPPING_CART | ||
ÉTOILE | BOUTIQUE | ||
TICKET | ENTRAÎNEMENT | ||
VIDEO_CAMERA | VIDEO_PLAY |
La Voici un exemple de carte avec une icône d'e-mail:
Ajouter une icône Google Material Design à une fiche
La
DecoratedText
et
ButtonList
Les widgets vous permettent d'utiliser les icônes Google Material
ce qui vous permet de choisir parmi plus de 2 500 icônes et de personnaliser
le poids, le remplissage et
le niveau des icônes.
Voici un exemple de carte avec une icône Google Material:
Ajouter une icône personnalisée à une carte
La
DecoratedText
et
ButtonList
Les widgets vous permettent d'utiliser les icônes intégrées ou de définir vos propres icônes personnalisées. À
ajouter une icône personnalisée à une fiche, inclure le champ iconUrl
et spécifier l'icône
l'URL correspondante.
Voici un exemple d'icône personnalisée: