Package google.apps.card.v1

Index

• Action (message)
• Action.ActionParameter (message)
• Action.Interaction (enum)
• Action.LoadIndicator (enum)
• BorderStyle (message)
• BorderStyle.BorderType (enum)
• Button (message)
• Button.Type (enum)
• ButtonList (message)
• Card (message)
• Card.CardAction (message)
• Card.CardFixedFooter (message)
• Card.CardHeader (message)
• Card.DisplayStyle (enum)
• Card.DividerStyle (enum)
• Card.NestedWidget (message)
• Card.Section (message)
• Carousel (message)
• Carousel.CarouselCard (message)
• Chip (message)
• ChipList (message)
• ChipList.Layout (enum)
• CollapseControl (message)
• Columns (message)
• Columns.Column (message)
• Columns.Column.HorizontalSizeStyle (enum)
• Columns.Column.VerticalAlignment (enum)
• Columns.Column.Widgets (message)
• DataActions (message)
• DateTimePicker (message)
• DateTimePicker.DateTimePickerType (enum)
• DecoratedText (message)
• DecoratedText.SwitchControl (message)
• DecoratedText.SwitchControl.ControlType (enum)
• Divider (message)
• EndNavigation (message)
• EndNavigation.Action (enum)
• GetAutocompletionResponse (message)
• Grid (message)
• Grid.GridItem (message)
• Grid.GridItem.GridItemLayout (enum)
• Icon (message)
• Image (message)
• ImageComponent (message)
• ImageCropStyle (message)
• ImageCropStyle.ImageCropType (enum)
• Link (message)
• LinkPreview (message)
• MaterialIcon (message)
• ModifyCard (message)
• ModifyCard.UpdateWidget (message)
• ModifyCard.UpdateWidget.SelectionInputWidgetSuggestions (message)
• Navigation (message)
• Notification (message)
• OnClick (message)
• OpenLink (message)
• OpenLink.OnClose (enum)
• OpenLink.OpenAs (enum)
• OverflowMenu (message)
• OverflowMenu.OverflowMenuItem (message)
• RenderActions (message)
• RenderActions.Action (message)
• SelectionInput (message)
• SelectionInput.PlatformDataSource (message)
• SelectionInput.PlatformDataSource.CommonDataSource (enum)
• SelectionInput.SelectionItem (message)
• SelectionInput.SelectionType (enum)
• SubmitFormResponse (message)
• Suggestions (message)
• Suggestions.SuggestionItem (message)
• TextInput (message)
• TextInput.Type (enum)
• TextParagraph (message)
• Validation (message)
• Validation.InputType (enum)
• Widget (message)
• Widget.HorizontalAlignment (enum)
• Widget.ImageType (enum)

Action

Action qui décrit le comportement lorsque le formulaire est envoyé. Par exemple, vous pouvez appeler un script Apps Script pour gérer le formulaire. Si l'action est déclenchée, les valeurs du formulaire sont envoyées au serveur.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
function	string Fonction personnalisée à appeler lorsque l'utilisateur clique sur l'élément contenant ou l'active de toute autre manière. Pour obtenir un exemple d'utilisation, consultez la section Lire les données de formulaire.
parameters[]	ActionParameter Liste des paramètres d'action.
loadIndicator	LoadIndicator Spécifie l'indicateur de chargement que l'action affiche lors de l'appel de l'action.
persistValues	bool Indique si les valeurs du formulaire persistent après l'action. La valeur par défaut est false. Si la valeur est true, les valeurs du formulaire restent après le déclenchement de l'action. Pour permettre à l'utilisateur de modifier l'action pendant son traitement, définissez LoadIndicator sur NONE. Pour les messages de fiche dans les applications Chat, vous devez également définir le ResponseType de l'action sur UPDATE_MESSAGE et utiliser le même card_id que celui de la fiche qui contenait l'action. Si la valeur est false, les valeurs du formulaire sont effacées lorsque l'action est déclenchée. Pour empêcher l'utilisateur de modifier l'action pendant son traitement, définissez LoadIndicator sur SPINNER.
interaction	Interaction Facultatif. Obligatoire lors de l'ouverture d'une boîte de dialogue. Action à effectuer en réponse à une interaction avec un utilisateur (par exemple, lorsqu'il clique sur un bouton dans un message de fiche). Si elle n'est pas spécifiée, l'application répond en exécutant un action (par exemple, en ouvrant un lien ou en exécutant une fonction) comme d'habitude. En spécifiant un interaction, l'application peut répondre de manière interactive particulière. Par exemple, en définissant interaction sur OPEN_DIALOG, l'application peut ouvrir une boîte de dialogue. Si spécifié, aucun indicateur de chargement ne s'affiche. Si cette valeur est spécifiée pour un module complémentaire, la carte entière est supprimée et rien n'est affiché dans le client. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.
requiredWidgets[]	string Facultatif. Renseignez cette liste avec les noms des widgets dont cette action a besoin pour une soumission valide. Si les widgets listés ici n'ont pas de valeur lorsque cette action est appelée, l'envoi du formulaire est interrompu. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
allWidgetsAreRequired	bool Facultatif. Si cette valeur est "true", tous les widgets sont considérés comme obligatoires pour cette action. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

ActionParameter

Liste des paramètres de chaîne à fournir lorsque la méthode d'action est appelée. Par exemple, considérons trois boutons de répétition: répéter maintenant, répéter un jour ou répéter la semaine prochaine. Vous pouvez utiliser action method = snooze(), en transmettant le type de rappel et la durée du rappel dans la liste des paramètres de chaîne.

Pour en savoir plus, consultez CommonEventObject.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
key	string Nom du paramètre du script d'action.
value	string Valeur du paramètre.

Interaction

Facultatif. Obligatoire lors de l'ouverture d'une boîte de dialogue.

Action à effectuer en réponse à une interaction avec un utilisateur (par exemple, lorsqu'il clique sur un bouton dans un message de fiche).

Si elle n'est pas spécifiée, l'application répond en exécutant un action (par exemple, en ouvrant un lien ou en exécutant une fonction) comme d'habitude.

En spécifiant un interaction, l'application peut répondre de manière interactive particulière. Par exemple, en définissant interaction sur OPEN_DIALOG, l'application peut ouvrir une boîte de dialogue.

Si spécifié, aucun indicateur de chargement ne s'affiche. Si cette valeur est spécifiée pour un module complémentaire, la carte entière est supprimée et rien n'est affiché dans le client.

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Enums
INTERACTION_UNSPECIFIED	Valeur par défaut. action s'exécute normalement.
OPEN_DIALOG	Ouvre une boîte de dialogue, une interface basée sur des cartes et sur une fenêtre que les applications Chat utilisent pour interagir avec les utilisateurs. Uniquement compatible avec les applications Chat en réponse aux clics sur les boutons des messages sous forme de fiche. Si cette valeur est spécifiée pour un module complémentaire, la carte entière est supprimée et rien n'est affiché dans le client. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

LoadIndicator

Spécifie l'indicateur de chargement que l'action affiche lors de l'appel de l'action.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
SPINNER	Affiche une icône de chargement pour indiquer que le contenu est en cours de chargement.
NONE	Rien ne s'affiche.

BorderStyle

Options de style pour la bordure d'une fiche ou d'un widget, y compris le type et la couleur de la bordure.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
type	BorderType Type de bordure.
strokeColor	Color Couleurs à utiliser lorsque le type est BORDER_TYPE_STROKE. Pour définir la couleur du trait, spécifiez une valeur pour les champs red, green et blue. Cette valeur doit être un nombre à virgule flottante compris entre 0 et 1, en fonction de la valeur de couleur RVB, où 0 (0/255) représente l'absence de couleur et 1 (255/255) l'intensité maximale de la couleur. Par exemple, l'exemple suivant définit la couleur rouge à son intensité maximale: "color": { "red": 1, "green": 0, "blue": 0, } Le champ alpha n'est pas disponible pour la couleur du trait. Si elle est spécifiée, ce champ est ignoré.
cornerRadius	int32 Rayon d'angle de la bordure.

BorderType

Représente les types de bordures appliqués aux widgets.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
BORDER_TYPE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
NO_BORDER	Aucune bordure.
STROKE	Valeur par défaut. Contour.

Bouton

Bouton de texte, d'icône ou de texte et d'icône sur lequel les utilisateurs peuvent cliquer. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un bouton.

Pour transformer une image en bouton cliquable, spécifiez un Image (et non un ImageComponent) et définissez une action onClick.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
text	string Texte affiché dans le bouton.
icon	Icon Icône affichée dans le bouton. Si icon et text sont tous deux définis, l'icône s'affiche avant le texte.
color	Color Facultatif. Couleur du bouton. Si cette valeur est définie, le bouton type est défini sur FILLED, et la couleur des champs text et icon est définie sur une couleur contrastante pour une meilleure lisibilité. Par exemple, si la couleur du bouton est définie sur bleu, le texte ou les icônes du bouton sont définis sur blanc. Pour définir la couleur du bouton, spécifiez une valeur pour les champs red, green et blue. Cette valeur doit être un nombre à virgule flottante compris entre 0 et 1, en fonction de la valeur de couleur RVB, où 0 (0/255) représente l'absence de couleur et 1 (255/255) l'intensité maximale de la couleur. Par exemple, l'exemple suivant définit la couleur rouge à son intensité maximale: "color": { "red": 1, "green": 0, "blue": 0, } Le champ alpha n'est pas disponible pour la couleur du bouton. Si elle est spécifiée, ce champ est ignoré.
onClick	OnClick Obligatoire. Action à effectuer lorsqu'un utilisateur clique sur le bouton, par exemple ouvrir un lien hypertexte ou exécuter une fonction personnalisée.
disabled	bool Si la valeur est true, le bouton s'affiche dans un état inactif et ne répond pas aux actions de l'utilisateur.
altText	string Texte de substitution utilisé à des fins d'accessibilité. Définissez un texte descriptif qui indique aux utilisateurs la fonction du bouton. Par exemple, si un bouton ouvre un lien hypertexte, vous pouvez écrire: "Ouvre un nouvel onglet du navigateur et accède à la documentation destinée aux développeurs Google Chat sur https://developers.google.com/workspace/chat".
type	Type Facultatif. Type de bouton. Si cette valeur n'est pas définie, le type de bouton est défini par défaut sur OUTLINED. Si le champ color est défini, le type de bouton est forcé sur FILLED et toute valeur définie pour ce champ est ignorée.

Type

Facultatif. Type d'un bouton. Si le champ color est défini, type est forcé sur FILLED.

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Enums
TYPE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
OUTLINED	Les boutons avec contours sont des boutons à accentuation moyenne. Ils contiennent généralement des actions importantes, mais qui ne sont pas l'action principale dans une application Chat ou un module complémentaire.
FILLED	Un bouton rempli comporte un conteneur de couleur unie. Il a le plus d'impact visuel et est recommandé pour l'action principale et importante d'une application Chat ou d'un module complémentaire.
FILLED_TONAL	Un bouton tonal rempli est un compromis entre les boutons remplis et ceux avec contour. Ils sont utiles dans les contextes où un bouton de priorité inférieure nécessite une accentuation légèrement plus forte que celle d'un bouton en contour.
BORDERLESS	Un bouton ne comporte pas de conteneur invisible dans son état par défaut. Il est souvent utilisé pour les actions de priorité la plus faible, en particulier lorsque plusieurs options sont présentées.

ButtonList

Liste de boutons disposés horizontalement. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un bouton.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
buttons[]	Button Tableau de boutons.

Fiche

Interface sous forme de fiche affichée dans un message Google Chat ou un module complémentaire Google Workspace.

Les fiches sont compatibles avec une mise en page définie, des éléments d'interface utilisateur interactifs tels que des boutons et des contenus multimédias enrichis tels que des images. Utilisez des fiches pour présenter des informations détaillées, collecter des informations auprès des utilisateurs et les guider vers la prochaine étape.

Concevez et prévisualisez des fiches à l'aide de l'outil de création de fiches.

Ouvrir l'outil de création de cartes

Pour savoir comment créer des fiches, consultez la documentation suivante:

• Pour les applications Google Chat, consultez Concevoir les composants d'une fiche ou d'une boîte de dialogue.
• Pour les modules complémentaires Google Workspace, consultez Interfaces basées sur des fiches.

Remarque: Vous pouvez ajouter jusqu'à 100 widgets par fiche. Les widgets au-delà de cette limite sont ignorés. Cette limite s'applique à la fois aux messages et aux boîtes de dialogue des cartes dans les applications Google Chat, ainsi qu'aux cartes des modules complémentaires Google Workspace.

Exemple: Message de fiche pour une application Google Chat

Pour créer l'exemple de message de carte dans Google Chat, utilisez le code JSON suivant:

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
           "title": "Sasha",
           "subtitle": "Software Engineer",
           "imageUrl":
           "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
           "imageType": "CIRCLE",
           "imageAltText": "Avatar for Sasha"
         },
         "sections": [
           {
             "header": "Contact Info",
             "collapsible": true,
             "uncollapsibleWidgetsCount": 1,
             "widgets": [
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "EMAIL"
                   },
                   "text": "[e-mail]"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "[phone]"
                 }
               },
               {
                 "buttonList": {
                   "buttons": [
                     {
                       "text": "Share",
                       "onClick": {
                        "openLink": {
                           "url": "https://example.com/share"
                         }
                       }
                     },
                     {
                       "text": "Edit",
                       "onClick": {
                         "action": {
                           "function": "goToView",
                           "parameters": [
                             {
                               "key": "viewType",
                               "value": "EDIT"
                             }
                           ]
                         }
                       }
                     }
                   ]
                 }
               }
             ]
           }
         ]
       }
    }
  ]
}

Champs
header	CardHeader En-tête de la fiche. Un en-tête contient généralement une image de titre et un titre. Les en-têtes s'affichent toujours en haut d'une fiche.
sections[]	Section Contient une collection de widgets. Chaque section possède son propre en-tête facultatif. Les sections sont séparées visuellement par une ligne de séparation. Pour voir un exemple dans les applications Google Chat, consultez Définir une section d'une fiche.
sectionDividerStyle	DividerStyle Style de séparateur entre l'en-tête, les sections et le pied de page.
cardActions[]	CardAction Actions de la fiche. Les actions sont ajoutées au menu de la barre d'outils de la fiche. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat. Par exemple, le code JSON suivant crée un menu d'actions de carte avec les options Settings et Send Feedback: "cardActions": [ { "actionLabel": "Settings", "onClick": { "action": { "functionName": "goToView", "parameters": [ { "key": "viewType", "value": "SETTING" } ], "loadIndicator": "LoadIndicator.SPINNER" } } }, { "actionLabel": "Send Feedback", "onClick": { "openLink": { "url": "https://example.com/feedback" } } } ]
name	string Nom de la fiche. Utilisé comme identifiant de carte dans la navigation par carte. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
fixedFooter	CardFixedFooter Pied de page fixe affiché en bas de cette fiche. Si vous définissez fixedFooter sans spécifier de primaryButton ou de secondaryButton, une erreur se produit. Pour les applications Chat, vous pouvez utiliser des pieds de page fixes dans les boîtes de dialogue, mais pas dans les messages de fiche. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
displayStyle	DisplayStyle Dans les modules complémentaires Google Workspace, définit les propriétés d'affichage de l'peekCardHeader. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
peekCardHeader	CardHeader Lorsque vous affichez du contenu contextuel, l'en-tête de la fiche Aperçu sert de place-tampon pour que l'utilisateur puisse naviguer entre les fiches de la page d'accueil et les fiches contextuelles. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

CardAction

Une action de fiche est l'action associée à la fiche. Par exemple, une fiche de facture peut inclure des actions telles que "Supprimer la facture", "Envoyer la facture par e-mail" ou "Ouvrir la facture dans un navigateur".

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Champs
actionLabel	string Libellé affiché en tant qu'élément de menu d'action.
onClick	OnClick Action onClick pour cet élément d'action.

CardFixedFooter

Pied de page persistant (adhésif) qui s'affiche en bas de la fiche.

Si vous définissez fixedFooter sans spécifier de primaryButton ou de secondaryButton, une erreur se produit.

Pour les applications Chat, vous pouvez utiliser des pieds de page fixes dans les boîtes de dialogue, mais pas dans les messages de fiche. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un pied de page persistant.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
primaryButton	Button Bouton principal du pied de page fixe. Le bouton doit être un bouton de texte avec du texte et une couleur définis.
secondaryButton	Button Bouton secondaire du pied de page fixe. Le bouton doit être un bouton de texte avec du texte et une couleur définis. Si secondaryButton est défini, vous devez également définir primaryButton.

CardHeader

Représente un en-tête de fiche. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un en-tête.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
title	string Obligatoire. Titre de l'en-tête de la fiche. La hauteur de l'en-tête est fixe: si un titre et un sous-titre sont spécifiés, chacun occupe une ligne. Si seul le titre est spécifié, il occupe les deux lignes.
subtitle	string Sous-titre de l'en-tête de la fiche. Si spécifié, apparaît sur sa propre ligne sous title.
imageType	ImageType Forme utilisée pour recadrer l'image. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
imageUrl	string URL HTTPS de l'image dans l'en-tête de la fiche.
imageAltText	string Texte alternatif de cette image utilisé pour l'accessibilité.

DisplayStyle

Dans les modules complémentaires Google Workspace, détermine la façon dont une fiche s'affiche.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Enums
DISPLAY_STYLE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
PEEK	L'en-tête de la fiche s'affiche en bas de la barre latérale, recouvrant partiellement la fiche supérieure actuelle de la pile. Cliquez sur l'en-tête pour insérer la fiche dans la pile. Si la fiche n'a pas d'en-tête, un en-tête généré est utilisé à la place.
REPLACE	Valeur par défaut. La fiche s'affiche en remplaçant la vue de la fiche supérieure de la pile.

DividerStyle

Style du séparateur d'une fiche. Actuellement, il n'est utilisé que pour les séparateurs entre les sections de la fiche.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
DIVIDER_STYLE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
SOLID_DIVIDER	Option par défaut. Affichez un séparateur plein.
NO_DIVIDER	Si elle est définie, aucun séparateur n'est affiché. Ce style supprime complètement le séparateur de la mise en page. Le résultat équivaut à ne pas ajouter de séparateur du tout.

NestedWidget

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Liste des widgets pouvant être affichés dans une mise en page contenant, telle qu'une CarouselCard. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Champs
Champ d'union data. data ne peut être qu'un des éléments suivants :
textParagraph	TextParagraph Widget de paragraphe de texte.
buttonList	ButtonList Widget de liste de boutons.
image	Image Widget Image

Section

Une section contient une collection de widgets qui sont affichés verticalement dans l'ordre dans lequel ils sont spécifiés.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
header	string Texte qui s'affiche en haut d'une section. Compatible avec le texte au format HTML simple. 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[]	Widget Tous les widgets de la section. Doit contenir au moins un widget.
collapsible	bool Indique si cette section peut être réduite. Les sections réductibles masquent certains ou tous les widgets, mais les utilisateurs peuvent développer la section pour afficher les widgets masqués en cliquant sur Afficher plus. Les utilisateurs peuvent à nouveau masquer les widgets en cliquant sur Afficher moins. Pour déterminer les widgets masqués, spécifiez uncollapsibleWidgetsCount.
uncollapsibleWidgetsCount	int32 Nombre de widgets non réductibles qui restent visibles même lorsqu'une section est réduite. Par exemple, lorsqu'une section contient cinq widgets et que uncollapsibleWidgetsCount est défini sur 2, les deux premiers widgets sont toujours affichés et les trois derniers sont réduits par défaut. uncollapsibleWidgetsCount n'est pris en compte que lorsque collapsible est défini sur true.
collapseControl	CollapseControl Facultatif. Définissez le bouton de développement et de réduction de la section. Ce bouton ne s'affiche que si la section est réductible. Si ce champ n'est pas défini, le bouton par défaut est utilisé.

Carrousel

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Un carrousel, également appelé curseur, fait pivoter et affiche une liste de widgets sous forme de diaporama, avec des boutons permettant d'accéder au widget précédent ou suivant.

Voici un exemple de représentation JSON d'un carrousel contenant trois widgets de paragraphes de texte.

{
  "carouselCards": [
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "First text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Second text paragraph in carousel",
          }
        }
      ]
    },
    {
      "widgets": [
        {
          "textParagraph": {
            "text": "Third text paragraph in carousel",
          }
        }
      ]
    }
  ]
}

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Champs
carouselCards[]	CarouselCard Liste des cartes incluses dans le carrousel.

CarouselCard

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Carte pouvant être affichée en tant qu'élément de carrousel. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Champs
widgets[]	NestedWidget Liste des widgets affichés dans la fiche de carrousel. Les widgets s'affichent dans l'ordre dans lequel ils sont spécifiés.
footerWidgets[]	NestedWidget Liste de widgets affichée en bas de la fiche de carrousel. Les widgets s'affichent dans l'ordre dans lequel ils sont spécifiés.

Puce

Chip de texte, d'icône ou de texte et d'icône sur lequel les utilisateurs peuvent cliquer.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
icon	Icon Image de l'icône. Si icon et text sont tous deux définis, l'icône s'affiche avant le texte.
label	string Texte affiché dans le chip.
onClick	OnClick Facultatif. Action à effectuer lorsqu'un utilisateur clique sur le chip, par exemple ouvrir un lien hypertexte ou exécuter une fonction personnalisée.
enabled (deprecated)	bool Cet élément est obsolète. Indique si le chip est dans un état actif et répond aux actions des utilisateurs. La valeur par défaut est true. Obsolète. Utilisez disabled à la place.
disabled	bool Indique si le chip est dans un état inactif et ignore les actions de l'utilisateur. La valeur par défaut est false.
altText	string Texte de substitution utilisé à des fins d'accessibilité. Définissez un texte descriptif qui indique aux utilisateurs ce que fait le chip. Par exemple, si un chip ouvre un lien hypertexte, écrivez: "Ouvre un nouvel onglet de navigateur et accède à la documentation destinée aux développeurs Google Chat sur https://developers.google.com/workspace/chat".

ChipList

Liste de chips disposés horizontalement, qui peut défiler horizontalement ou se terminer à la ligne suivante.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
layout	Layout Mise en page de la liste de chips spécifiée.
chips[]	Chip Tableau de puces.

Mise en page

Mise en page de la liste de chips.

Enums
LAYOUT_UNSPECIFIED	Ne pas utiliser. Non spécifié.
WRAPPED	Valeur par défaut. La liste de chips passe à la ligne suivante si l'espace horizontal est insuffisant.
HORIZONTAL_SCROLLABLE	Les chips défilent horizontalement s'ils ne rentrent pas dans l'espace disponible.

CollapseControl

Représenter un bouton de développement et de réduction

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
horizontalAlignment	HorizontalAlignment Alignement horizontal du bouton de développement et de réduction.
expandButton	Button Facultatif. Définissez un bouton personnalisable pour développer la section. Les champs expandButton et collapseButton doivent être définis. Seul un seul ensemble de champs ne sera pas appliqué. Si ce champ n'est pas défini, le bouton par défaut est utilisé.
collapseButton	Button Facultatif. Définissez un bouton personnalisable pour réduire la section. Les champs expandButton et collapseButton doivent être définis. Seul un seul ensemble de champs ne sera pas appliqué. Si ce champ n'est pas défini, le bouton par défaut est utilisé.

Colonnes

Le widget Columns affiche jusqu'à deux colonnes dans une fiche ou une boîte de dialogue. Vous pouvez ajouter des widgets à chaque colonne. Ils s'affichent dans l'ordre dans lequel ils sont spécifiés. Pour obtenir un exemple dans les applications Google Chat, consultez Afficher des cartes et des boîtes de dialogue dans des colonnes.

La hauteur de chaque colonne est déterminée par la colonne la plus haute. Par exemple, si la première colonne est plus haute que la deuxième, les deux colonnes ont la même hauteur. Étant donné que chaque colonne peut contenir un nombre différent de widgets, vous ne pouvez pas définir de lignes ni aligner les widgets entre les colonnes.

Les colonnes sont affichées côte à côte. Vous pouvez personnaliser la largeur de chaque colonne à l'aide du champ HorizontalSizeStyle. Si la largeur de l'écran de l'utilisateur est trop étroite, la deuxième colonne se place sous la première:

• Sur le Web, la deuxième colonne se plie si la largeur de l'écran est inférieure ou égale à 480 pixels.
• Sur les appareils iOS, la deuxième colonne se plie si la largeur de l'écran est inférieure ou égale à 300 pt.
• Sur les appareils Android, la deuxième colonne se plie si la largeur de l'écran est inférieure ou égale à 320 dp.

Pour inclure plus de deux colonnes ou utiliser des lignes, utilisez le widget Grid.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace. Les UI de modules complémentaires compatibles avec les colonnes incluent les suivantes:

• Boîte de dialogue affichée lorsque les utilisateurs ouvrent le module complémentaire à partir d'un brouillon d'e-mail.
• Boîte de dialogue qui s'affiche lorsque les utilisateurs ouvrent le module complémentaire à partir du menu Ajouter une pièce jointe dans un événement Google Agenda.

Champs
columnItems[]	Column Tableau de colonnes. Vous pouvez inclure jusqu'à deux colonnes dans une fiche ou une boîte de dialogue.

Colonne

Une colonne.

Modules complémentaires Google Workspace et applications Chat

Champs
horizontalSizeStyle	HorizontalSizeStyle Indique comment une colonne remplit la largeur de la fiche.
horizontalAlignment	HorizontalAlignment Indique si les widgets doivent être alignés à gauche, à droite ou au centre d'une colonne.
verticalAlignment	VerticalAlignment Indique si les widgets doivent être alignés en haut, en bas ou au centre d'une colonne.
widgets[]	Widgets Tableau de widgets inclus dans une colonne. Les widgets s'affichent dans l'ordre dans lequel ils sont spécifiés.

HorizontalSizeStyle

Indique comment une colonne remplit la largeur de la fiche. La largeur de chaque colonne dépend à la fois de HorizontalSizeStyle et de la largeur des widgets de la colonne.

Modules complémentaires Google Workspace et applications Chat

Enums
HORIZONTAL_SIZE_STYLE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
FILL_AVAILABLE_SPACE	Valeur par défaut. La colonne occupe l'espace disponible, jusqu'à 70% de la largeur de la fiche. Si les deux colonnes sont définies sur FILL_AVAILABLE_SPACE, chacune occupe 50% de l'espace.
FILL_MINIMUM_SPACE	La colonne occupe le moins d'espace possible et pas plus de 30% de la largeur de la fiche.

VerticalAlignment

Indique si les widgets doivent être alignés en haut, en bas ou au centre d'une colonne.

Modules complémentaires Google Workspace et applications Chat

Enums
VERTICAL_ALIGNMENT_UNSPECIFIED	Ne pas utiliser. Non spécifié.
CENTER	Valeur par défaut. Aligne les widgets au centre d'une colonne.
TOP	Aligne les widgets en haut d'une colonne.
BOTTOM	Aligne les widgets en bas d'une colonne.

Widgets

Widgets compatibles que vous pouvez inclure dans une colonne

Modules complémentaires Google Workspace et applications Chat

Champs
Champ d'union data. data ne peut être qu'un des éléments suivants :
textParagraph	TextParagraph Widget TextParagraph
image	Image Widget Image
decoratedText	DecoratedText Widget DecoratedText
buttonList	ButtonList Widget ButtonList
textInput	TextInput Widget TextInput
selectionInput	SelectionInput Widget SelectionInput
dateTimePicker	DateTimePicker Widget DateTimePicker
chipList	ChipList Widget ChipList

DataActions

Action du module complémentaire qui met à jour les données Google Workspace.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Champs
hostAppDataAction	HostAppDataActionMarkup Définit la façon de mettre à jour les données Google Workspace.

DateTimePicker

Permet aux utilisateurs de saisir une date, une heure ou les deux. Prend en charge la validation de l'envoi du formulaire. Lorsque Action.all_widgets_are_required est défini sur true ou que ce widget est spécifié dans Action.required_widgets, l'action d'envoi est bloquée, sauf si une valeur est sélectionnée. Pour obtenir un exemple dans les applications Google Chat, consultez Permettre à un utilisateur de choisir une date et une heure.

Les utilisateurs peuvent saisir du texte ou utiliser le sélecteur pour sélectionner des dates et des heures. Si les utilisateurs saisissent une date ou une heure incorrecte, le sélecteur affiche une erreur qui les invite à saisir les informations correctement.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
name	string Nom par lequel l'DateTimePicker est identifié dans un événement de saisie de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
label	string Texte qui invite les utilisateurs à saisir une date, une heure ou une date et une heure. Par exemple, si les utilisateurs planifient un rendez-vous, utilisez un libellé tel que Appointment date ou Appointment date and time.
type	DateTimePickerType Indique si le widget permet de saisir une date, une heure ou les deux.
valueMsEpoch	int64 Valeur par défaut affichée dans le widget, en millisecondes depuis l'epoch Unix. Spécifiez la valeur en fonction du type de sélecteur (DateTimePickerType): DATE_AND_TIME: date et heure au format UTC. Par exemple, pour représenter le 1er janvier 2023 à 12h00 UTC, utilisez 1672574400000. DATE_ONLY: date du calendrier à 00:00:00 UTC. Par exemple, pour représenter le 1er janvier 2023, utilisez 1672531200000. TIME_ONLY: heure au format UTC. Par exemple, pour représenter 12h00, utilisez 43200000 (ou 12 * 60 * 60 * 1000).
timezoneOffsetDate	int32 Nombre représentant le décalage horaire par rapport à UTC, en minutes. Si ce champ est défini, value_ms_epoch s'affiche dans le fuseau horaire spécifié. Si ce paramètre n'est pas défini, la valeur par défaut est celle du fuseau horaire de l'utilisateur.
onChangeAction	Action Déclenché lorsque l'utilisateur clique sur Enregistrer ou Effacer dans l'interface DateTimePicker.

DateTimePickerType

Format de la date et de l'heure dans le widget DateTimePicker. Détermine si les utilisateurs peuvent saisir une date, une heure ou les deux.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
DATE_AND_TIME	Les utilisateurs saisissent une date et une heure.
DATE_ONLY	Les utilisateurs saisissent une date.
TIME_ONLY	Les utilisateurs saisissent une heure.

DecoratedText

Widget qui affiche du texte avec des décorations facultatives, telles qu'un libellé au-dessus ou en dessous du texte, une icône devant le texte, un widget de sélection ou un bouton après le texte. Pour obtenir un exemple dans les applications Google Chat, consultez Afficher du texte avec du texte décoratif.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
icon (deprecated)	Icon Cet élément est obsolète. Abandonné et remplacé par startIcon.
startIcon	Icon Icône affichée devant le texte.
topLabel	string Texte qui s'affiche au-dessus de text. Toujours tronqué.
text	string Obligatoire. Texte principal. Compatible avec la mise en forme simple. 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.
wrapText	bool Paramètre de retour à la ligne. Si la valeur est true, le texte se scinde et s'affiche sur plusieurs lignes. Sinon, le texte est tronqué. S'applique uniquement à text, et non à topLabel et bottomLabel.
bottomLabel	string Texte qui s'affiche sous text. Toujours mise en forme.
onClick	OnClick Cette action est déclenchée lorsque les utilisateurs cliquent sur topLabel ou bottomLabel.
Champ d'union control. Bouton, bouton d'activation/de désactivation, case à cocher ou image qui s'affiche à droite du texte dans le widget decoratedText. La control ne peut être qu'un des éléments suivants :
button	Button Bouton sur lequel un utilisateur peut cliquer pour déclencher une action.
switchControl	SwitchControl Widget de bouton bascule sur lequel un utilisateur peut cliquer pour modifier son état et déclencher une action.
endIcon	Icon Icône affichée après le texte. Compatible avec les icônes intégrées et personnalisées.

SwitchControl

Un bouton d'activation/de désactivation ou une case à cocher dans un widget decoratedText.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Compatible uniquement avec le widget decoratedText.

Champs
name	string Nom par lequel le widget de bouton bascule est identifié dans un événement d'entrée de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
value	string Valeur saisie par un utilisateur, renvoyée dans le cadre d'un événement de saisie de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
selected	bool Lorsque true est sélectionné, le bouton bascule est activé.
onChangeAction	Action Action à effectuer lorsque l'état du bouton est modifié, par exemple la fonction à exécuter.
controlType	ControlType Affichage du bouton dans l'interface utilisateur. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

ControlType

Affichage du bouton dans l'interface utilisateur.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
SWITCH	Un bouton d'activation/de désactivation.
CHECKBOX	Abandonné et remplacé par CHECK_BOX.
CHECK_BOX	Case à cocher.

Séparateur

Ce type ne comporte aucun champ.

Affiche une ligne horizontale entre les widgets. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter une ligne de séparation horizontale entre les widgets.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Par exemple, le code JSON suivant crée un séparateur:

"divider": {}

EndNavigation

Pour les modules complémentaires dans Google Chat, ferme une boîte de dialogue.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Champs
action	Action Pour les modules complémentaires dans Google Chat, action qui permet de fermer une boîte de dialogue. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Action

Pour les modules complémentaires dans Google Chat, actions pour EndNavigation.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Enums
ACTION_UNSPECIFIED	Action non spécifiée.
CLOSE_DIALOG	Ferme une boîte de dialogue.
CLOSE_DIALOG_AND_EXECUTE	Ferme une boîte de dialogue et actualise la fiche qui l'a ouverte.

GetAutocompletionResponse

Réponse à l'obtention du conteneur de saisie semi-automatique, qui inclut les éléments nécessaires à l'affichage des éléments de saisie semi-automatique pour le champ de texte.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat. Exemple :

{
  "autoComplete": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

Champs
autoComplete	Suggestions
schema	string Il s'agit d'un champ de schéma sans opération qui peut être présent dans le balisage pour la vérification de la syntaxe.

Grille

Affiche une grille avec une collection d'éléments. Les éléments ne peuvent contenir que du texte ou des images. Pour les colonnes responsives ou pour inclure plus de texte ou d'images, utilisez Columns. Pour obtenir un exemple dans les applications Google Chat, consultez Afficher une grille avec une collection d'éléments.

Une grille peut comporter un nombre illimité de colonnes et d'éléments. Le nombre de lignes est déterminé par le nombre d'éléments divisé par le nombre de colonnes. Une grille de 10 éléments et de deux colonnes comporte cinq lignes. Une grille avec 11 éléments et deux colonnes comporte six lignes.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Par exemple, le code JSON suivant crée une grille à deux colonnes avec un seul élément:

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

Champs
title	string Texte affiché dans l'en-tête de la grille.
items[]	GridItem Éléments à afficher dans la grille.
borderStyle	BorderStyle Style de bordure à appliquer à chaque élément de la grille.
columnCount	int32 Nombre de colonnes à afficher dans la grille. Si ce champ n'est pas spécifié, une valeur par défaut est utilisée. Cette valeur par défaut est différente selon l'emplacement de la grille (boîte de dialogue ou application associée).
onClick	OnClick Ce rappel est réutilisé par chaque élément de la grille, mais avec l'identifiant et l'index de l'élément dans la liste des éléments ajoutés aux paramètres du rappel.

GridItem

Représente un élément dans une mise en page en grille. Les éléments peuvent contenir du texte, une image ou les deux.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
id	string Identifiant spécifié par l'utilisateur pour cet élément de grille. Cet identifiant est renvoyé dans les paramètres de rappel onClick de la grille parente.
image	ImageComponent Image affichée dans l'élément de la grille.
title	string Titre de l'élément de la grille.
subtitle	string Sous-titre de l'élément de la grille.
layout	GridItemLayout Mise en page à utiliser pour l'élément de grille.

GridItemLayout

Représente les différentes options de mise en page disponibles pour un élément de grille.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
GRID_ITEM_LAYOUT_UNSPECIFIED	Ne pas utiliser. Non spécifié.
TEXT_BELOW	Le titre et le sous-titre s'affichent sous l'image de l'élément de la grille.
TEXT_ABOVE	Le titre et le sous-titre s'affichent au-dessus de l'image de l'élément de la grille.

Icône

Icône affichée dans un widget sur une fiche. Pour voir un exemple dans les applications Google Chat, consultez Ajouter une icône.

Compatible avec les icônes intégrées et personnalisées.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
altText	string Facultatif. Description de l'icône utilisée pour l'accessibilité. Si elle n'est pas spécifiée, la valeur par défaut Button est fournie. Il est recommandé de définir une description utile de ce que l'icône affiche et, le cas échéant, de son fonctionnement. Par exemple, A user's account portrait ou Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat. Si l'icône est définie dans un Button, le altText s'affiche sous forme de texte d'aide lorsque l'utilisateur pointe sur le bouton. Toutefois, si le bouton définit également text, l'altText de l'icône est ignoré.
imageType	ImageType Style de recadrage appliqué à l'image. Dans certains cas, l'application d'un recadrage CIRCLE entraîne l'affichage de l'image plus grande qu'une icône intégrée.
Champ d'union icons. Icône affichée dans le widget de la fiche. icons ne peut être qu'un des éléments suivants :
knownIcon	string Afficher l'une des icônes intégrées fournies par Google Workspace Par exemple, pour afficher une icône en forme d'avion, spécifiez AIRPLANE. Pour un bus, spécifiez BUS. Pour obtenir la liste complète des icônes compatibles, consultez la section Icônes intégrées.
iconUrl	string Afficher une icône personnalisée hébergée sur une URL HTTPS Exemple : "iconUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png" Les types de fichiers acceptés sont .png et .jpg.
materialIcon	MaterialIcon Affichez l'une des icônes Google Material. Par exemple, pour afficher une icône de case à cocher, utilisez "materialIcon": { "name": "check_box" } Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Image

Image spécifiée par une URL et pouvant comporter une action onClick. Pour obtenir un exemple, consultez Ajouter une image.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
imageUrl	string URL HTTPS qui héberge l'image. Exemple : https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png
onClick	OnClick Lorsqu'un utilisateur clique sur l'image, ce clic déclenche cette action.
altText	string Texte alternatif de cette image utilisé pour l'accessibilité.

ImageComponent

Représente une image.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
imageUri	string URL de l'image.
altText	string Libellé d'accessibilité de l'image.
cropStyle	ImageCropStyle Style de recadrage à appliquer à l'image.
borderStyle	BorderStyle Style de bordure à appliquer à l'image.

ImageCropStyle

Représente le style de recadrage appliqué à une image.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Par exemple, voici comment appliquer un format 16:9:

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

Champs
type	ImageCropType Type de recadrage.
aspectRatio	double Format à utiliser si le type de recadrage est RECTANGLE_CUSTOM. Par exemple, voici comment appliquer un format 16:9: cropStyle { "type": "RECTANGLE_CUSTOM", "aspectRatio": 16/9 }

ImageCropType

Représente le style de recadrage appliqué à une image.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
IMAGE_CROP_TYPE_UNSPECIFIED	Ne pas utiliser. Non spécifié.
SQUARE	Valeur par défaut. Applique un recadrage carré.
CIRCLE	Applique un recadrage circulaire.
RECTANGLE_CUSTOM	Applique un recadrage rectangulaire avec un format personnalisé. Définissez le format personnalisé avec aspectRatio.
RECTANGLE_4_3	Applique un recadrage rectangulaire au format 4:3.

Lien

Objet de lien de la ressource tierce renvoyée au module complémentaire. Pour en savoir plus, consultez Créer des ressources tierces à partir du menu @.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Champs
url	string URL du lien permettant de revenir au module complémentaire.
title	string Titre du lien permettant de revenir au module complémentaire.

LinkPreview

Action de carte qui présente un lien tiers en affichant une carte et un chip intelligent. Pour en savoir plus, consultez Prévisualiser des liens avec les chips intelligents.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Par exemple, le code JSON suivant renvoie un titre unique pour l'aperçu du lien et son chip intelligent, ainsi qu'une fiche d'aperçu avec un en-tête et une description textuelle:

{
  "action": {
    "linkPreview": {
      "title": "Smart chip title",
      "linkPreviewTitle": "Link preview title",
      "previewCard": {
        "header": {
          "title": "Preview card header",
        },
        "sections": [
          {
            "widgets": [
              {
                "textParagraph": {
                  "text": "Description of the link."
                }
              }
            ]
          }
        ]
      }
    }
  }
}

L'exemple renvoie l'aperçu du lien suivant:

Champs
previewCard	Card Fiche qui affiche des informations sur un lien provenant d'un service tiers.
title	string Titre qui s'affiche dans le chip intelligent pour l'aperçu du lien. Si cette valeur n'est pas définie, le chip intelligent affiche l'en-tête de preview_card.
linkPreviewTitle	string Titre qui s'affiche dans l'aperçu du lien. Si cette valeur n'est pas définie, l'aperçu du lien affiche l'en-tête de l'preview_card.

MaterialIcon

Une icône Material de Google, qui comprend plus de 2 500 options.

Par exemple, pour afficher une icône de case à cocher avec une pondération et une note personnalisées, écrivez ce qui suit:

{
  "name": "check_box",
  "fill": true,
  "weight": 300,
  "grade": -25
}

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Champs
name	string Nom de l'icône défini dans l'icône Google Material, par exemple check_box. Les noms non valides sont abandonnés et remplacés par une chaîne vide. L'icône ne s'affiche alors pas.
fill	bool Indique si l'icône est remplie. La valeur par défaut est Faux (false). Pour prévisualiser différents paramètres d'icône, accédez à Icônes de police Google et ajustez les paramètres sous Personnaliser.
weight	int32 Épaisseur du trait de l'icône. Choisissez parmi {100, 200, 300, 400, 500, 600, 700}. Si elle est absente, la valeur par défaut est 400. Si une autre valeur est spécifiée, la valeur par défaut est utilisée. Pour prévisualiser différents paramètres d'icône, accédez à Icônes de police Google et ajustez les paramètres sous Personnaliser.
grade	int32 L'épaisseur et le niveau ont une incidence sur l'épaisseur d'un symbole. Les ajustements de l'épaisseur sont plus précis que ceux de l'épaisseur et ont un faible impact sur la taille du symbole. Choisissez parmi {-25, 0, 200}. Si elle est absente, la valeur par défaut est 0. Si une autre valeur est spécifiée, la valeur par défaut est utilisée. Pour prévisualiser différents paramètres d'icône, accédez à Icônes de police Google et ajustez les paramètres sous Personnaliser.

ModifyCard

Pour les modules complémentaires dans Google Chat, met à jour une fiche en fonction d'une interaction utilisateur. Le tableau ne doit contenir qu'un seul objet.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Champs
Champ d'union operation. operation ne peut être qu'un des éléments suivants :
updateWidget	UpdateWidget Pour les modules complémentaires dans Google Chat, met à jour un widget dans une fiche ou une boîte de dialogue. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

UpdateWidget

Pour les modules complémentaires dans Google Chat, met à jour un widget dans une fiche ou une boîte de dialogue.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Champs
Champ d'union updated_widget. Mises à jour d'un widget. updated_widget ne peut être qu'un des éléments suivants :
selectionInputWidgetSuggestions	SelectionInputWidgetSuggestions Pour les widgets selectionInput, tableau d'éléments suggérés dans un menu à sélection multiple. Lorsqu'un menu à sélection multiple utilise une source de données externe pour renseigner ses éléments, le widget peut renseigner dynamiquement des suggestions en fonction de ce que l'utilisateur saisit dans le menu. Pour en savoir plus, consultez Collecter des informations auprès des utilisateurs de Google Chat. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

SelectionInputWidgetSuggestions

Pour un widget selectionInput qui utilise un menu à sélection multiple, renvoie les éléments de sélection à partir d'une source de données dynamique externe.

Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Champs
suggestions[]	SelectionItem Tableau d'éléments sélectionnables qui s'affichent après qu'un utilisateur a saisi du texte dans un menu à sélection multiple. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Navigation

Met à jour ou permet de passer d'une fiche à l'autre dans une pile de fiches.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Exemple :

1) Retourner une nouvelle carte (parcourir vers l'avant).

 navigations : {
    pushCard : CARD
  }

2) Mettre à jour la fiche en haut de la pile (mise à jour in situ).

  navigations : {
    popCard : true,
  }, {
    pushCard : CARD
  }

3) Revenez en arrière d'une étape sans mettre à jour.

  navigations : {
    popCard : true,
  }

4) Revenez en arrière de plusieurs étapes et mettez à jour cette carte.

  navigations : {
    popCard : true,
  }, ... {
    pushCard : CARD
  }

5) Revenir en arrière de plusieurs étapes jusqu'à un CARD_NAME défini.

  navigations : {
    popToCardName : CARD_NAME,
  }, {
    pushCard : CARD
  }

6) Revenez à la racine et mettez à jour cette fiche.

  navigations : {
    popToRoot : true
  }, {
    pushCard : CARD
  }

7) Accédez à la fiche spécifiée et ouvrez-la également.

navigations : { popToCardName : CARD_NAME }, { popCard : true, }

8) Remplacez la carte du dessus par une nouvelle.

  navigations : {
    updateCard : CARD
  }

Champs
Champ d'union navigate_action. navigate_action ne peut être qu'un des éléments suivants :
popToRoot	bool Retire toutes les cartes, à l'exception de la carte racine.
pop	bool Éjecte une carte.
popToCard	string Fait apparaître toutes les fiches situées au-dessus de la fiche spécifiée avec le nom de la fiche donné.
pushCard	Card Transfère une carte sur la pile de cartes. Preview développeur: pour les boîtes de dialogue dans Google Chat, ouvre ou met à jour une boîte de dialogue.
updateCard	Card Remplace la carte supérieure par une nouvelle carte et conserve les valeurs des champs de formulaire remplis. Pour un champ non équivalent, la valeur est supprimée. Preview développeur: pour les boîtes de dialogue dans Google Chat, ouvre ou met à jour une boîte de dialogue.
endNavigation	EndNavigation Pour les modules complémentaires dans Google Chat, ferme une boîte de dialogue. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Notification

Action qui affiche une notification dans l'application Google Workspace hôte lorsqu'un utilisateur interagit avec une fiche.

Preview développeur: pour les modules complémentaires dans Google Chat, affiche une notification lorsque les utilisateurs envoient et ferment une boîte de dialogue.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Champs
text	string Texte brut à afficher pour la notification, sans balises HTML.

OnClick

Représente la réponse à donner lorsque les utilisateurs cliquent sur un élément interactif d'une fiche, tel qu'un bouton.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
Champ d'union data. data ne peut être qu'un des éléments suivants :
action	Action Si cet élément est spécifié, une action est déclenchée par ce onClick.
openLink	OpenLink Si elle est spécifiée, cette onClick déclenche une action d'ouverture de lien.
openDynamicLinkAction	Action Un module complémentaire déclenche cette action lorsqu'il doit ouvrir un lien. Il diffère de open_link ci-dessus en ce sens qu'il doit communiquer avec le serveur pour obtenir le lien. Par conséquent, le client Web doit effectuer un certain travail de préparation avant que la réponse à l'action d'ouverture du lien ne soit renvoyée. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
card	Card Si spécifié, une nouvelle fiche est ajoutée à la pile de cartes après le clic. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
overflowMenu	OverflowMenu Si elle est spécifiée, cette onClick ouvre un menu à développer.

OpenLink

Représente un événement onClick qui ouvre un lien hypertexte.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
url	string URL à ouvrir.
openAs	OpenAs Comment ouvrir un lien Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
onClose	OnClose Indique si le client oublie un lien après l'avoir ouvert ou s'il l'observe jusqu'à ce que la fenêtre se ferme. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

OnClose

Action du client lorsqu'un lien ouvert par une action OnClick est fermé.

L'implémentation dépend des fonctionnalités de la plate-forme cliente. Par exemple, un navigateur Web peut ouvrir un lien dans une fenêtre pop-up avec un gestionnaire OnClose.

Si les gestionnaires OnOpen et OnClose sont tous deux définis et que la plate-forme cliente ne peut pas prendre en charge les deux valeurs, OnClose prévaut.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Enums
NOTHING	Valeur par défaut. La carte ne se recharge pas. Rien ne se passe.
RELOAD	Recharge la carte une fois la fenêtre enfant fermée. Si elle est utilisée avec OpenAs.OVERLAY, la fenêtre enfant agit comme une boîte de dialogue modale et la fiche parente est bloquée jusqu'à la fermeture de la fenêtre enfant.

OpenAs

Lorsqu'une action OnClick ouvre un lien, le client peut l'ouvrir en tant que fenêtre pleine taille (s'il s'agit du frame utilisé par le client) ou en tant que superposition (par exemple, un pop-up). L'implémentation dépend des fonctionnalités de la plate-forme cliente. La valeur sélectionnée peut être ignorée si le client ne la prend pas en charge. FULL_SIZE est compatible avec tous les clients.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Enums
FULL_SIZE	Le lien s'ouvre dans une fenêtre pleine taille (si c'est le frame utilisé par le client).
OVERLAY	Le lien s'ouvre en superposition, par exemple dans un pop-up.

OverflowMenu

Widget qui présente un menu pop-up avec une ou plusieurs actions que les utilisateurs peuvent appeler. (par exemple, afficher des actions non principales dans une fiche). Vous pouvez utiliser ce widget lorsque les actions ne rentrent pas dans l'espace disponible. Pour l'utiliser, spécifiez ce widget dans l'action OnClick des widgets qui le prennent en charge. Par exemple, dans un Button.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
items[]	OverflowMenuItem Obligatoire. Liste des options du menu.

OverflowMenuItem

Option que les utilisateurs peuvent appeler dans un menu à développer.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
startIcon	Icon Icône affichée devant le texte.
text	string Obligatoire. Texte qui identifie ou décrit l'élément pour les utilisateurs.
onClick	OnClick Obligatoire. Action appelée lorsqu'une option de menu est sélectionnée. Cet élément OnClick ne peut pas contenir d'élément OverflowMenu. Tout élément OverflowMenu spécifié est supprimé et l'élément de menu est désactivé.
disabled	bool Indique si l'option de menu est désactivée. Valeur par défaut : "false".

RenderActions

Ensemble d'instructions de rendu qui indique au module complémentaire d'effectuer une action dans une fiche ou dans l'application hôte.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Champs
action	Action Action que les modules complémentaires peuvent utiliser pour mettre à jour l'UI. Preview développeur: Modules complémentaires dans Google Chat.
hostAppAction	HostAppActionMarkup Actions gérées par des applications hôtes individuelles.
schema	string Il s'agit d'un champ de schéma sans opération qui peut être présent dans le balisage pour la vérification de la syntaxe.

Action

Actions que les modules complémentaires peuvent utiliser dans les fiches ou l'application hôte.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.

Champs
navigations[]	Navigation Affiche, affiche ou met à jour une fiche. Preview développeur: Modules complémentaires dans Google Chat.
link	OpenLink Ouvre le lien cible dans un nouvel onglet ou une nouvelle fenêtre pop-up.
notification	Notification Affiche une notification dans l'application Google Workspace hôte lorsqu'un utilisateur interagit avec une fiche. Preview développeur: pour les modules complémentaires dans Google Chat, affiche une notification lorsque les utilisateurs envoient et ferment une boîte de dialogue.
linkPreview	LinkPreview Disponible dans Google Docs, Google Sheets et Google Slides. Prévisualise les liens avec les chips intelligents et la carte. Pour en savoir plus, consultez Prévisualiser des liens avec des chips intelligents.
links[]	Link Disponible dans Google Docs. Renvoie un lien à partir d'une ressource tierce et le convertit en chip intelligent dans l'application hôte. Formaté en tant que tableau d'objets avec un seul élément. Pour en savoir plus, consultez Créer des ressources tierces à partir du menu @.
modifyOperations[]	ModifyCard Pour les modules complémentaires dans Google Chat, met à jour une fiche en fonction d'une interaction utilisateur. Le tableau ne doit contenir qu'un seul objet. Preview développeur:disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

SelectionInput

Widget qui crée un ou plusieurs éléments d'interface utilisateur que les utilisateurs peuvent sélectionner. Compatible avec la validation de l'envoi de formulaires pour les menus dropdown et multiselect uniquement. Lorsque Action.all_widgets_are_required est défini sur true ou que ce widget est spécifié dans Action.required_widgets, l'action d'envoi est bloquée, sauf si une valeur est sélectionnée. Par exemple, un menu déroulant ou des cases à cocher. Vous pouvez utiliser ce widget pour collecter des données pouvant être prédites ou énumérées. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter des éléments d'interface utilisateur sélectionnables.

Les applications de chat peuvent traiter la valeur des éléments que les utilisateurs sélectionnent ou saisissent. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.

Pour collecter des données indéfinies ou abstraites auprès des utilisateurs, utilisez le widget TextInput.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
name	string Obligatoire. Nom qui identifie la sélection dans un événement d'entrée de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
label	string Texte qui s'affiche au-dessus du champ de saisie de sélection dans l'interface utilisateur. Spécifiez un texte qui aide l'utilisateur à saisir les informations dont votre application a besoin. Par exemple, si les utilisateurs sélectionnent l'urgence d'une demande de service dans un menu déroulant, le libellé peut être "Urgence" ou "Sélectionner l'urgence".
type	SelectionType Type d'éléments affichés aux utilisateurs dans un widget SelectionInput. Les types de sélection sont compatibles avec différents types d'interactions. Par exemple, les utilisateurs peuvent cocher une ou plusieurs cases, mais ils ne peuvent sélectionner qu'une seule valeur dans un menu déroulant.
items[]	SelectionItem Tableau d'éléments sélectionnables. Par exemple, un tableau de boutons d'option ou de cases à cocher. Accepte jusqu'à 100 éléments.
onChangeAction	Action Si elle est spécifiée, le formulaire est envoyé lorsque la sélection change. Si ce n'est pas le cas, vous devez spécifier un bouton distinct qui envoie le formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
multiSelectMaxSelectedItems	int32 Pour les menus à sélection multiple, nombre maximal d'éléments qu'un utilisateur peut sélectionner. La valeur minimale est de 1 article. Si aucune valeur n'est spécifiée, la valeur par défaut est de trois éléments.
multiSelectMinQueryLength	int32 Pour les menus à sélection multiple, nombre de caractères de texte saisis par l'utilisateur avant que le menu ne renvoie des suggestions d'éléments de sélection. Si elle n'est pas définie, le menu à sélection multiple utilise les valeurs par défaut suivantes: Si le menu utilise un tableau statique d'éléments SelectionInput, la valeur par défaut est de 0 caractères et les éléments du tableau sont immédiatement renseignés. Si le menu utilise une source de données dynamique (multi_select_data_source), trois caractères sont définis par défaut avant d'interroger la source de données pour renvoyer des suggestions d'éléments.
Champ d'union multi_select_data_source. Pour un menu à sélection multiple, une source de données qui renseigne dynamiquement les éléments de sélection. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace. multi_select_data_source ne peut être qu'un des éléments suivants :
externalDataSource	Action Une source de données externe, telle qu'une base de données relationnelle.
platformDataSource	PlatformDataSource Une source de données Google Workspace.

PlatformDataSource

Pour un widget SelectionInput qui utilise un menu à sélection multiple, une source de données Google Workspace. Permet de renseigner les éléments d'un menu à sélection multiple.

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Champs
Champ d'union data_source. Source de données. data_source ne peut être qu'un des éléments suivants :
commonDataSource	CommonDataSource Source de données partagée par toutes les applications Google Workspace, telles que les utilisateurs d'une organisation Google Workspace.
hostAppDataSource	HostAppDataSourceMarkup Source de données propre à une application hôte Google Workspace, comme les espaces dans Google Chat. Ce champ est compatible avec les bibliothèques clientes des API Google, mais n'est pas disponible dans les bibliothèques clientes Cloud. Pour en savoir plus, consultez Installer les bibliothèques clientes.

CommonDataSource

Source de données partagée par toutes les applications Google Workspace.

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Enums
UNKNOWN	Valeur par défaut. Ne pas utiliser.
USER	Utilisateurs de Google Workspace L'utilisateur ne peut afficher et sélectionner que des utilisateurs de son organisation Google Workspace.

SelectionItem

Élément que les utilisateurs peuvent sélectionner dans une entrée de sélection, comme une case à cocher ou un bouton. Accepte jusqu'à 100 éléments.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
text	string Texte qui identifie ou décrit l'élément pour les utilisateurs.
value	string Valeur associée à cet élément. Le client doit l'utiliser comme valeur d'entrée de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
selected	bool Indique si l'élément est sélectionné par défaut. Si la zone de saisie de sélection n'accepte qu'une seule valeur (par exemple, pour les boutons d'option ou un menu déroulant), ne définissez ce champ que pour un seul élément.
startIconUri	string Pour les menus à sélection multiple, URL de l'icône affichée à côté du champ text de l'élément. Compatible avec les fichiers PNG et JPEG. Doit être une URL HTTPS. Par exemple, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
bottomText	string Pour les menus à sélection multiple, description ou libellé textuel affiché sous le champ text de l'élément.

SelectionType

Format des éléments que les utilisateurs peuvent sélectionner. Différentes options sont compatibles avec différents types d'interactions. Par exemple, les utilisateurs peuvent cocher plusieurs cases, mais ne peuvent sélectionner qu'un seul élément dans un menu déroulant.

Chaque champ de saisie de sélection accepte un type de sélection. Il n'est pas possible, par exemple, de mélanger des cases à cocher et des boutons d'activation/de désactivation.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
CHECK_BOX	Ensemble de cases à cocher. Les utilisateurs peuvent cocher une ou plusieurs cases.
RADIO_BUTTON	Ensemble de cases d'option. Les utilisateurs peuvent sélectionner une seule case d'option.
SWITCH	Ensemble d'interrupteurs. Les utilisateurs peuvent activer un ou plusieurs boutons.
DROPDOWN	Un menu déroulant. Les utilisateurs peuvent sélectionner un élément dans le menu.
MULTI_SELECT	Menu avec une zone de texte. Les utilisateurs peuvent saisir du texte et sélectionner un ou plusieurs éléments. Pour les modules complémentaires Google Workspace, vous devez renseigner les éléments à l'aide d'un tableau statique d'objets SelectionItem. Pour les applications Google Chat, vous pouvez également renseigner des éléments à l'aide d'une source de données dynamique et suggérer automatiquement des éléments lorsque les utilisateurs saisissent du texte dans le menu. Par exemple, les utilisateurs peuvent commencer à saisir le nom d'un espace Google Chat, et le widget leur suggère automatiquement l'espace. Pour renseigner dynamiquement les éléments d'un menu à sélection multiple, utilisez l'un des types de sources de données suivants: Données Google Workspace: les éléments sont renseignés à l'aide de données Google Workspace, telles que les utilisateurs Google Workspace ou les espaces Google Chat. Données externes: les éléments sont renseignés à partir d'une source de données externe à Google Workspace. Pour découvrir comment implémenter des menus à sélection multiple pour les applications Chat, consultez Ajouter un menu à sélection multiple. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

SubmitFormResponse

Réponse à l'envoi d'un formulaire autre que l'obtention d'un conteneur de saisie semi-automatique, qui contient les actions que la fiche doit effectuer et/ou l'application hôte du module complémentaire, et si l'état de la fiche a changé.

Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat. Exemple :

{
  "renderActions": {
    "action": {
      "notification": {
        "text": "Email address is added: [e-mail]"
      }
    },
    "hostAppAction": {
      "gmailAction": {
        "openCreatedDraftAction": {
          "draftId": "msg-a:r-79766936926021702",
          "threadServerPermId": "thread-f:15700999851086004"
        }
      }
    }
  }
}

Champs
renderActions	RenderActions Ensemble d'instructions de rendu qui indique à la fiche d'effectuer une action et/ou à l'application hôte du module complémentaire d'effectuer une action spécifique à l'application.
stateChanged	bool Indique si l'état des fiches a changé et si les données des fiches existantes sont obsolètes.
schema	string Il s'agit d'un champ de schéma sans opération qui peut être présent dans le balisage pour le contrôle de la syntaxe.

Suggestions

Valeurs suggérées que les utilisateurs peuvent saisir. Ces valeurs s'affichent lorsque les utilisateurs cliquent dans le champ de saisie de texte. À mesure que les utilisateurs saisissent du texte, les valeurs suggérées sont filtrées de manière dynamique pour correspondre à ce qu'ils ont saisi.

Par exemple, un champ de saisie de texte pour un langage de programmation peut suggérer Java, JavaScript, Python et C++. Lorsque les utilisateurs commencent à saisir Jav, la liste des suggestions se filtre pour afficher Java et JavaScript.

Les valeurs suggérées aident les utilisateurs à saisir des valeurs que votre application peut interpréter. Lorsqu'ils font référence à JavaScript, certains utilisateurs peuvent saisir javascript et d'autres java script. En suggérant JavaScript, vous pouvez standardiser la façon dont les utilisateurs interagissent avec votre application.

Lorsque TextInput.type est spécifié, il est toujours SINGLE_LINE, même s'il est défini sur MULTIPLE_LINE.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
items[]	SuggestionItem Liste de suggestions utilisées pour les recommandations de saisie semi-automatique dans les champs de saisie de texte.

SuggestionItem

Valeur suggérée que les utilisateurs peuvent saisir dans un champ de saisie de texte.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
Champ d'union content. content ne peut être qu'un des éléments suivants :
text	string Valeur d'une suggestion d'entrée dans un champ de saisie de texte. Il s'agit de ce que les utilisateurs saisissent eux-mêmes.

TextInput

Champ dans lequel les utilisateurs peuvent saisir du texte. Compatible avec les suggestions et les actions en cas de modification. Prend en charge la validation de l'envoi du formulaire. Lorsque Action.all_widgets_are_required est défini sur true ou que ce widget est spécifié dans Action.required_widgets, l'action d'envoi est bloquée, sauf si une valeur est saisie. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un champ dans lequel un utilisateur peut saisir du texte.

Les applications Chat reçoivent et peuvent traiter la valeur du texte saisi lors des événements d'entrée de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.

Lorsque vous devez collecter des données indéfinies ou abstraites auprès des utilisateurs, utilisez une saisie de texte. Pour collecter des données définies ou énumérées auprès des utilisateurs, utilisez le widget SelectionInput.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
name	string Nom par lequel la saisie de texte est identifiée dans un événement de saisie de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
label	string Texte qui s'affiche au-dessus du champ de saisie de texte dans l'interface utilisateur. Spécifiez un texte qui aide l'utilisateur à saisir les informations dont votre application a besoin. Par exemple, si vous demandez le nom d'une personne, mais que vous avez spécifiquement besoin de son nom de famille, saisissez surname au lieu de name. Obligatoire si hintText n'est pas spécifié. Sinon, facultatif.
hintText	string Texte qui s'affiche sous le champ de saisie de texte pour aider les utilisateurs à saisir une valeur spécifique. Ce texte est toujours visible. Obligatoire si label n'est pas spécifié. Sinon, facultatif.
value	string Valeur saisie par un utilisateur, renvoyée dans le cadre d'un événement de saisie de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
type	Type Affichage d'un champ de saisie de texte dans l'interface utilisateur. Par exemple, si le champ est à une ou plusieurs lignes.
onChangeAction	Action Que faire lorsqu'un changement se produit dans le champ de saisie de texte ? Par exemple, un utilisateur ajoute du texte dans le champ ou en supprime. Par exemple, vous pouvez exécuter une fonction personnalisée ou ouvrir une boîte de dialogue dans Google Chat.
initialSuggestions	Suggestions Valeurs suggérées que les utilisateurs peuvent saisir. Ces valeurs s'affichent lorsque les utilisateurs cliquent dans le champ de saisie de texte. À mesure que les utilisateurs saisissent du texte, les valeurs suggérées sont filtrées de manière dynamique pour correspondre à ce qu'ils ont saisi. Par exemple, un champ de saisie de texte pour un langage de programmation peut suggérer Java, JavaScript, Python et C++. Lorsque les utilisateurs commencent à saisir Jav, la liste des suggestions se filtre pour n'afficher que Java et JavaScript. Les valeurs suggérées aident les utilisateurs à saisir des valeurs que votre application peut interpréter. Lorsqu'ils font référence à JavaScript, certains utilisateurs peuvent saisir javascript et d'autres java script. En suggérant JavaScript, vous pouvez standardiser la façon dont les utilisateurs interagissent avec votre application. Lorsque TextInput.type est spécifié, il est toujours SINGLE_LINE, même s'il est défini sur MULTIPLE_LINE. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
autoCompleteAction	Action Facultatif. Spécifiez l'action à effectuer lorsque le champ de saisie de texte fournit des suggestions aux utilisateurs qui interagissent avec lui. Si cette valeur n'est pas spécifiée, les suggestions sont définies par initialSuggestions et traitées par le client. Si elle est spécifiée, l'application effectue l'action indiquée ici, par exemple exécuter une fonction personnalisée. Disponible pour les modules complémentaires Google Workspace et indisponible pour les applications Google Chat.
validation	Validation Spécifiez la validation du format d'entrée nécessaire pour ce champ de texte. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
placeholderText	string Texte qui s'affiche dans le champ de saisie de texte lorsqu'il est vide. Utilisez ce texte pour inviter les utilisateurs à saisir une valeur. Par exemple, Enter a number from 0 to 100. Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Type

Affichage d'un champ de saisie de texte dans l'interface utilisateur. Par exemple, s'il s'agit d'un champ de saisie sur une seule ligne ou de plusieurs lignes. Si initialSuggestions est spécifié, type est toujours SINGLE_LINE, même s'il est défini sur MULTIPLE_LINE.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
SINGLE_LINE	Le champ de saisie de texte a une hauteur fixe d'une ligne.
MULTIPLE_LINE	Le champ de saisie de texte a une hauteur fixe de plusieurs lignes.

TextParagraph

Paragraphe de texte compatible avec la mise en forme. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un paragraphe de texte mis en forme. 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.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
text	string Texte affiché dans le widget.
maxLines	int32 Nombre maximal de lignes de texte affichées dans le widget. Si le texte dépasse le nombre maximal de lignes spécifié, le contenu excédentaire est masqué derrière un bouton Afficher plus. Si le texte est égal ou inférieur au nombre maximal de lignes spécifié, aucun bouton Afficher plus ne s'affiche. La valeur par défaut est 0, ce qui signifie que tout le contexte est affiché. Les valeurs négatives sont ignorées.

Validation

Représente les données nécessaires pour valider le widget auquel il est associé.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Champs
characterLimit	int32 Spécifiez la limite de caractères pour les widgets de saisie de texte. Notez que cette option n'est utilisée que pour la saisie de texte et est ignorée pour les autres widgets. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
inputType	InputType Spécifiez le type des widgets de saisie. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

InputType

Type du widget de saisie.

Enums
INPUT_TYPE_UNSPECIFIED	Type non spécifié. Ne pas utiliser.
TEXT	Texte standard qui accepte tous les caractères.
INTEGER	Valeur entière.
FLOAT	Valeur flottante.
EMAIL	Adresse e-mail
EMOJI_PICKER	Emoji sélectionné dans le sélecteur d'emoji fourni par le système.

Widget

Chaque fiche est composée de widgets.

Un widget est un objet composite qui peut représenter du texte, des images, des boutons et d'autres types d'objets.

Champs
horizontalAlignment	HorizontalAlignment Indique si les widgets doivent être alignés à gauche, à droite ou au centre d'une colonne.
Champ d'union data. Un widget ne peut contenir qu'un seul des éléments suivants. Vous pouvez utiliser plusieurs champs de widget pour afficher plus d'éléments. data ne peut être qu'un des éléments suivants :
textParagraph	TextParagraph Affiche un paragraphe de texte. Compatible avec le texte au format HTML simple. 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. Par exemple, le code JSON suivant crée un texte en gras: "textParagraph": { "text": " <b>bold text</b>" }
image	Image Affiche une image. Par exemple, le code JSON suivant crée une image avec du texte alternatif: "image": { "imageUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png", "altText": "Chat app avatar" }
decoratedText	DecoratedText Affiche un élément textuel décoré. Par exemple, le code JSON suivant crée un widget de texte décoré affichant une adresse e-mail: "decoratedText": { "icon": { "knownIcon": "EMAIL" }, "topLabel": "Email Address", "text": "[e-mail]", "bottomLabel": "This is a new Email address!", "switchControl": { "name": "has_send_welcome_email_to_sasha", "selected": false, "controlType": "CHECKBOX" } }
buttonList	ButtonList Liste des boutons. Par exemple, le code JSON suivant crée deux boutons. Le premier est un bouton de texte bleu, et le second est un bouton image qui ouvre un lien: "buttonList": { "buttons": [ { "text": "Edit", "color": { "red": 0, "green": 0, "blue": 1, }, "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }
textInput	TextInput Affiche une zone de texte dans laquelle les utilisateurs peuvent saisir du texte. Par exemple, le code JSON suivant crée une zone de saisie de texte pour une adresse e-mail: "textInput": { "name": "mailing_address", "label": "Mailing Address" } Par exemple, le code JSON suivant crée une entrée de texte pour un langage de programmation avec des suggestions statiques: "textInput": { "name": "preferred_programing_language", "label": "Preferred Language", "initialSuggestions": { "items": [ { "text": "C++" }, { "text": "Java" }, { "text": "JavaScript" }, { "text": "Python" } ] } }
selectionInput	SelectionInput Affiche une commande de sélection permettant aux utilisateurs de sélectionner des éléments. Les commandes de sélection peuvent être des cases à cocher, des cases d'option, des boutons bascule ou des menus déroulants. Par exemple, le code JSON suivant crée un menu déroulant permettant aux utilisateurs de choisir une taille: "selectionInput": { "name": "size", "label": "Size" "type": "DROPDOWN", "items": [ { "text": "S", "value": "small", "selected": false }, { "text": "M", "value": "medium", "selected": true }, { "text": "L", "value": "large", "selected": false }, { "text": "XL", "value": "extra_large", "selected": false } ] }
dateTimePicker	DateTimePicker Affiche un widget permettant aux utilisateurs de saisir une date, une heure ou une date et une heure. Par exemple, le code JSON suivant crée un sélecteur de date et d'heure pour planifier un rendez-vous: "dateTimePicker": { "name": "appointment_time", "label": "Book your appointment at:", "type": "DATE_AND_TIME", "valueMsEpoch": "796435200000" }
divider	Divider Affiche une ligne horizontale de séparation entre les widgets. Par exemple, le code JSON suivant crée un séparateur: "divider": { }
grid	Grid Affiche une grille avec une collection d'éléments. Une grille peut comporter un nombre illimité de colonnes et d'éléments. Le nombre de lignes est déterminé par la limite supérieure du nombre d'articles divisé par le nombre de colonnes. Une grille de 10 éléments et de deux colonnes comporte cinq lignes. Une grille avec 11 éléments et deux colonnes comporte six lignes. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace. Par exemple, le code JSON suivant crée une grille à deux colonnes avec un seul élément: "grid": { "title": "A fine collection of items", "columnCount": 2, "borderStyle": { "type": "STROKE", "cornerRadius": 4 }, "items": [ { "image": { "imageUri": "https://www.example.com/image.png", "cropStyle": { "type": "SQUARE" }, "borderStyle": { "type": "STROKE" } }, "title": "An item", "textAlignment": "CENTER" } ], "onClick": { "openLink": { "url": "https://www.example.com" } } }
columns	Columns Affiche jusqu'à deux colonnes. Pour inclure plus de deux colonnes ou utiliser des lignes, utilisez le widget Grid. Par exemple, le code JSON suivant crée deux colonnes contenant chacune des paragraphes de texte: "columns": { "columnItems": [ { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "First column text paragraph" } } ] }, { "horizontalSizeStyle": "FILL_AVAILABLE_SPACE", "horizontalAlignment": "CENTER", "verticalAlignment": "CENTER", "widgets": [ { "textParagraph": { "text": "Second column text paragraph" } } ] } ] }
carousel	Carousel Un carrousel contient un ensemble de widgets imbriqués. Voici un exemple de représentation JSON d'un carrousel contenant deux paragraphes de texte. { "widgets": [ { "textParagraph": { "text": "First text paragraph in the carousel." } }, { "textParagraph": { "text": "Second text paragraph in the carousel." } } ] }
chipList	ChipList Liste des chips. Par exemple, le code JSON suivant crée deux chips. Le premier est un chip de texte, et le second est un chip d'icône qui ouvre un lien: "chipList": { "chips": [ { "text": "Edit", "disabled": true, }, { "icon": { "knownIcon": "INVITE", "altText": "check calendar" }, "onClick": { "openLink": { "url": "https://example.com/calendar" } } } ] }

HorizontalAlignment

Indique si les widgets doivent être alignés à gauche, à droite ou au centre d'une colonne.

Disponible pour les applications Google Chat et indisponible pour les modules complémentaires Google Workspace.

Enums
HORIZONTAL_ALIGNMENT_UNSPECIFIED	Ne pas utiliser. Non spécifié.
START	Valeur par défaut. Aligne les widgets sur la position de début de la colonne. Pour les mises en page de gauche à droite, s'aligne à gauche. Pour les mises en page de droite à gauche, s'aligne à droite.
CENTER	Aligne les widgets au centre de la colonne.
END	Aligne les widgets à la fin de la colonne. Pour les mises en page de gauche à droite, aligne les widgets à droite. Pour les mises en page de droite à gauche, aligne les widgets à gauche.

ImageType

Forme utilisée pour recadrer l'image.

Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

Enums
SQUARE	Valeur par défaut. Applique un masque carré à l'image. Par exemple, une image de 4 x 3 devient 3 x 3.
CIRCLE	Applique un masque circulaire à l'image. Par exemple, une image de 4 x 3 pixels devient un cercle de 3 cm de diamètre.