Fiche
Une carte est un élément d'interface utilisateur qui peut contenir des widgets d'interface utilisateur, tels que du texte et des images.
Représentation JSON |
---|
{ "header": { object ( |
Champs | |
---|---|
header
|
En-tête de la carte. Un en-tête contient généralement un titre et une image. |
sections[]
|
Les sections sont séparées par un séparateur de lignes. |
cardActions[]
|
Actions associées à cette fiche. |
name
|
Nom de la carte. |
CardHeader
Représentation JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Champs | |
---|---|
title
|
Vous devez indiquer le titre. L'en-tête a une hauteur fixe: si un titre et un sous-titre sont tous les deux spécifiés, chacun occupe une ligne. Si seul le titre est spécifié, il occupe les deux lignes. |
subtitle
|
Sous-titre de l'en-tête de la carte. |
imageStyle
|
Type de l'image (par exemple, bordure carrée ou bordure circulaire) |
imageUrl
|
URL de l'image dans l'en-tête de la fiche. |
ImageStyle
Enums | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
Bordure carrée. |
AVATAR
|
Bordure circulaire. |
Section
Une section contient un ensemble de widgets affichés (verticalement) dans l'ordre dans lequel ils sont spécifiés. Sur toutes les plates-formes, les fiches ont une largeur fixe étroite. Les propriétés de mise en page (par exemple, float, par exemple) ne sont donc pas nécessaires pour le moment.
Représentation JSON |
---|
{
"header": string,
"widgets": [
{
object (
|
Champs | |
---|---|
header
|
En-tête de la section. Le texte mis en forme est accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme le texte dans les modules complémentaires Google Workspace |
widgets[]
|
Une section doit contenir au moins un widget. |
WidgetMarkup
Un widget est un élément d'interface utilisateur qui présente du texte et des images.
Représentation JSON |
---|
{ "buttons": [ { object ( |
Champs | |
---|---|
buttons[]
|
Liste de boutons. Les boutons sont également
|
Champ d'union
data A
WidgetMarkup
ne peut contenir que l'un des éléments suivants. Vous pouvez utiliser plusieurs
WidgetMarkup
pour afficher plus d'éléments.
data
ne peut être que l'un des éléments suivants:
|
|
textParagraph
|
Affichez un paragraphe de texte dans ce widget. |
image
|
Affichez une image dans ce widget. |
keyValue
|
Affichez un élément clé-valeur dans ce widget. |
TextParagraph
Un paragraphe de texte. Texte mis en forme accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme le texte dans les modules complémentaires Google Workspace
Représentation JSON |
---|
{ "text": string } |
Champs | |
---|---|
text
|
|
Image
Une image spécifiée par une URL et pouvant avoir une
onclick
action.
Représentation JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Champs | |
---|---|
imageUrl
|
URL de l'image |
onClick
|
La
|
aspectRatio
|
Proportions de cette image (largeur et hauteur). Ce champ vous permet de réserver la hauteur adaptée à l'image en attendant son chargement. Elle n'est pas destinée à remplacer le format intégré de l'image. Si cette règle n'est pas configurée, le serveur la remplit en préchargeant l'image. |
OnClick
Une
onclick
(par exemple, ouvrir un lien).
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union
|
|
action
|
Une action de formulaire est déclenchée
|
openLink
|
Ce
|
FormAction
Une action dans un formulaire décrit le comportement qui s'applique lors de l'envoi du formulaire. Par exemple, vous pouvez appeler Apps Script pour gérer le formulaire.
Représentation JSON |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
Champs | |
---|---|
actionMethodName
|
Le nom de la méthode permet d'identifier la partie du formulaire qui a déclenché son envoi. Ces informations sont renvoyées à l'application Chat dans le cadre de l'événement de clic sur la fiche. Vous pouvez utiliser le même nom de méthode pour plusieurs éléments qui déclenchent un comportement courant. |
parameters[]
|
Liste des paramètres d'action. |
ActionParameter
Liste des paramètres de chaîne à fournir lorsque la méthode d'action est appelée. Prenons l'exemple de trois boutons de mise en attente: répéter maintenant, répéter un jour et répéter la semaine suivante. Vous pourriez utiliser
action method = snooze()
, en transmettant le type et la durée de la mise en pause dans la liste des paramètres de chaîne.
Représentation JSON |
---|
{ "key": string, "value": string } |
Champs | |
---|---|
key
|
Nom du paramètre pour le script d'action. |
value
|
Valeur du paramètre. |
OpenLink
Lien qui ouvre une nouvelle fenêtre.
Représentation JSON |
---|
{ "url": string } |
Champs | |
---|---|
url
|
URL à ouvrir. |
KeyValue
Un élément d'interface utilisateur contient une clé (étiquette) et une valeur (contenu). Cet élément peut également contenir des actions telles que
onclick
.
Représentation JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Champs | |
---|---|
topLabel
|
Texte du libellé du haut. Texte mis en forme accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme le texte dans les modules complémentaires Google Workspace |
content
|
Texte du contenu. Le texte mis en forme est accepté et toujours obligatoire. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme le texte dans les modules complémentaires Google Workspace |
contentMultiline
|
Indique si le contenu doit être multiligne. |
bottomLabel
|
Texte du libellé du bas. Texte mis en forme accepté. Pour en savoir plus sur la mise en forme du texte, consultez Mettre en forme du texte dans les applications Google Chat et Mettre en forme le texte dans les modules complémentaires Google Workspace |
onClick
|
La
|
Champ d'union
icons Au moins une des icônes,
top_label
et
bottom_label
doit être définie.
icons
ne peut être que l'un des éléments suivants:
|
|
icon
|
Valeur d'énumération remplacée par l'API Chat par l'icône correspondante. |
iconUrl
|
Icône spécifiée par une URL. |
Champ d'union
control Un widget de contrôle. Vous pouvez définir
button
ou
switch_widget , mais pas les deux.
control
ne peut être que l'un des éléments suivants:
|
|
button
|
Un bouton sur lequel l'utilisateur peut cliquer pour déclencher une action. |
Icône
Ensemble des icônes compatibles.
Enums | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
Bouton
Un bouton Il peut s'agir d'un bouton de type texte ou image.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union
|
|
textButton
|
Un bouton avec du texte et
|
imageButton
|
Un bouton avec une image et
|
TextButton
Un bouton avec du texte et
onclick
action.
Représentation JSON |
---|
{
"text": string,
"onClick": {
object (
|
Champs | |
---|---|
text
|
Texte du bouton |
onClick
|
La
|
ImageButton
Un bouton "Image" avec
onclick
action.
Représentation JSON |
---|
{ "onClick": { object ( |
Champs | |
---|---|
onClick
|
La
|
name
|
Le nom de ce
|
Champ d'union
icons L'icône peut être spécifiée par un élément
Icon
enum
ou une URL.
icons
ne peut être que l'un des éléments suivants:
|
|
icon
|
L'icône spécifiée par un
|
iconUrl
|
Icône spécifiée par une URL. |
CardAction
Une action est associée à la fiche. Pour une fiche de facture, vous pouvez supprimer la facture, l'envoyer par e-mail ou ouvrir la facture dans un navigateur.
Non compatible avec les applications Google Chat.
Représentation JSON |
---|
{
"actionLabel": string,
"onClick": {
object (
|
Champs | |
---|---|
actionLabel
|
Libellé qui apparaissait dans l'élément de menu d'actions. |
onClick
|
L'action "onclick" pour cet élément d'action. |