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 une ligne. |
cardActions[]
|
Actions de cette fiche. |
name
|
Le nom de la carte. |
CardHeader
Représentation JSON |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
Champs | |
---|---|
title
|
Vous devez indiquer un titre. L'en-tête a une hauteur fixe: si un titre et un sous-titre sont spécifiés, chacun d'eux 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 une collection de widgets qui sont 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. Il n'est donc actuellement pas nécessaire de définir des propriétés de mise en page (par exemple, une valeur flottante).
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 du texte dans les modules complémentaires Google Workspace. |
widgets[]
|
Chaque 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[]
|
Une liste de boutons La valeur "Buttons" est également définie sur |
Champ d'union data . Un élément WidgetMarkup ne peut contenir qu'un seul des éléments suivants. Vous pouvez utiliser plusieurs champs WidgetMarkup pour afficher plus d'éléments.
data ne peut être que l'un des éléments suivants:
|
|
textParagraph
|
Afficher 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
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 du texte dans les modules complémentaires Google Workspace.
Représentation JSON |
---|
{ "text": string } |
Champs | |
---|---|
text
|
|
Images
Image spécifiée par une URL et pouvant être associée à une action onclick
.
Représentation JSON |
---|
{
"imageUrl": string,
"onClick": {
object (
|
Champs | |
---|---|
imageUrl
|
URL de l'image |
onClick
|
L'action |
aspectRatio
|
Format de cette image (largeur et hauteur). Ce champ vous permet de réserver la hauteur appropriée pour l'image en attendant son chargement. Il n'est pas destiné à 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 action onclick
(par exemple, ouvrir un lien).
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union
|
|
action
|
Si elle est spécifiée, une action de formulaire est déclenchée par cette action |
openLink
|
Cette action |
FormAction
Une action de formulaire décrit le comportement 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é l'envoi. Ces informations sont renvoyées à l'application Chat lors 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 commun. |
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 Répéter: Répéter maintenant, Répéter un jour, Répéter la semaine suivante. Vous pouvez utiliser action method = snooze()
pour transmettre le type et la durée de 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 du 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é (libellé) et une valeur (contenu). Cet élément peut également contenir des actions telles que le bouton onclick
.
Représentation JSON |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
Champs | |
---|---|
topLabel
|
Texte du libellé supérieur. 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 du texte dans les modules complémentaires Google Workspace. |
content
|
Texte du contenu. Texte mis en forme 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 du texte dans les modules complémentaires Google Workspace. |
contentMultiline
|
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 du texte dans les modules complémentaires Google Workspace. |
onClick
|
L'action |
Champ d'union icons . Vous devez définir au moins l'une des icônes, top_label et bottom_label .
icons ne peut être que l'un des éléments suivants:
|
|
icon
|
Valeur d'énumération remplacée par l'API Chat par l'image d'icône correspondante. |
iconUrl
|
Icône spécifiée par une URL. |
Champ d'union control . Un widget de commande. 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. |
Icon
Ensemble d'icônes prises en charge.
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 textuel ou d'un bouton image.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union
|
|
textButton
|
Un bouton avec du texte et une action |
imageButton
|
Un bouton avec une image et une action |
TextButton
Un bouton avec du texte et une action onclick
.
Représentation JSON |
---|
{
"text": string,
"onClick": {
object (
|
Champs | |
---|---|
text
|
Texte du bouton |
onClick
|
Action |
ImageButton
Un bouton image avec une action onclick
.
Représentation JSON |
---|
{ "onClick": { object ( |
Champs | |
---|---|
onClick
|
L'action |
name
|
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
|
Icône spécifiée par un élément |
iconUrl
|
Icône spécifiée par une URL. |
CardAction
Une action sur la fiche correspond à l'action associée à la fiche. En général, pour une fiche de facturation, 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 s'affichait auparavant dans l'élément du menu d'actions. |
onClick
|
Action Dialogflow pour cette tâche. |