Cette page a été traduite par l'API Cloud Translation.

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)
DateTimePicker (message)
DateTimePicker.DateTimePickerType (enum)
DecoratedText (message)
DecoratedText.SwitchControl (message)
DecoratedText.SwitchControl.ControlType (enum)
Divider (message)
Grid (message)
Grid.GridItem (message)
Grid.GridItem.GridItemLayout (enum)
Icon (message)
Image (message)
ImageComponent (message)
ImageCropStyle (message)
ImageCropStyle.ImageCropType (enum)
MaterialIcon (message)
OnClick (message)
OpenLink (message)
OpenLink.OnClose (enum)
OpenLink.OpenAs (enum)
OverflowMenu (message)
OverflowMenu.OverflowMenuItem (message)
SelectionInput (message)
SelectionInput.PlatformDataSource (message)
SelectionInput.PlatformDataSource.CommonDataSource (enum)
SelectionInput.SelectionItem (message)
SelectionInput.SelectionType (enum)
Suggestions (message)
Suggestions.SuggestionItem (message)
TextInput (message)
TextInput.Type (enum)
TextParagraph (message)
TextParagraph.TextSyntax (enum)
Validation (message)
Validation.InputType (enum)
Widget (message)
Widget.HorizontalAlignment (enum)
Widget.ImageType (enum)
Widget.VerticalAlignment (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'élément conteneur est cliqué ou activé d'une autre manière. Pour obtenir des exemples d'utilisation, consultez Lire les données de formulaire.
`parameters[]`	`ActionParameter` Liste des paramètres d'action.
`load_indicator`	`LoadIndicator` Spécifie l'indicateur de chargement que l'action affiche lors de l'appel à l'action.
`persist_values`	`bool` Indique si les valeurs du formulaire sont conservées après l'action. La valeur par défaut est `false`. Si la valeur est `true`, les valeurs du formulaire sont conservées après le déclenchement de l'action. Pour permettre à l'utilisateur d'apporter des modifications pendant le traitement de l'action, 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 contenant 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 d'apporter des modifications pendant le traitement de l'action, 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` (comme ouvrir un lien ou exécuter une fonction) normalement. En spécifiant un `interaction`, l'application peut répondre de manière interactive spéciale. 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 n'est affiché. Si elle 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, mais pas pour les modules complémentaires Google Workspace.
`required_widgets[]`	`string` Facultatif. Remplissez 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 annulé. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
`all_widgets_are_required`	`bool` Facultatif. Si la valeur est "true", tous les widgets sont considérés comme requis par 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, pensez à trois boutons de report : "Reporter maintenant", "Reporter d'un jour" ou "Reporter d'une semaine". Vous pouvez utiliser action method = snooze() en transmettant le type et la durée de la mise en veille 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

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

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 (comme ouvrir un lien ou exécuter une fonction) normalement.

En spécifiant un interaction, l'application peut répondre de manière interactive spéciale. 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 n'est affiché. Si elle 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, mais pas pour les modules complémentaires Google Workspace.

Enums

INTERACTION_UNSPECIFIED Valeur par défaut. Le action s'exécute normalement.

Enums
`INTERACTION_UNSPECIFIED`	Valeur par défaut. Le `action` s'exécute normalement.
`OPEN_DIALOG`	Ouvre une boîte de dialogue, une interface fenêtrée basée sur des fiches que les applications Chat utilisent pour interagir avec les utilisateurs. Uniquement pris en charge par les applications Chat en réponse aux clics sur les boutons des messages sous forme de fiches. Si elle 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, mais pas pour les modules complémentaires Google Workspace.

OPEN_DIALOG

Ouvre une boîte de dialogue, une interface fenêtrée basée sur des fiches que les applications Chat utilisent pour interagir avec les utilisateurs.

Uniquement pris en charge par les applications Chat en réponse aux clics sur les boutons des messages sous forme de fiches. Si elle 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, mais pas pour les modules complémentaires Google Workspace.

LoadIndicator

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

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

Enums
`SPINNER`	Affiche un indicateur 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

Champs
`type`	`BorderType` Type de bordure.
`stroke_color`	`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`. La valeur doit être un nombre à virgule flottante compris entre 0 et 1, basé sur la valeur RVB de la couleur, où `0` (0/255) représente l'absence de couleur et `1` (255/255) représente l'intensité maximale de la couleur. Par exemple, la ligne suivante définit la couleur sur rouge à son intensité maximale : `"color": { "red": 1, "green": 0, "blue": 0, }` Le champ `alpha` n'est pas disponible pour la couleur du trait. Si ce champ est spécifié, il est ignoré.
`corner_radius`	`int32` Rayon d'angle de la bordure.

type

BorderType

Type de bordure.

stroke_color

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. La valeur doit être un nombre à virgule flottante compris entre 0 et 1, basé sur la valeur RVB de la couleur, où 0 (0/255) représente l'absence de couleur et 1 (255/255) représente l'intensité maximale de la couleur.

Par exemple, la ligne suivante définit la couleur sur rouge à son intensité maximale :

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

Le champ alpha n'est pas disponible pour la couleur du trait. Si ce champ est spécifié, il est ignoré.

corner_radius

int32

Rayon d'angle de la bordure.

BorderType

Représente les types de bordure 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 avec du texte, une icône, ou du texte et une 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 les deux paramètres `icon` et `text` sont définis, l'icône s'affiche avant le texte.
`color`	`Color` Facultatif. Couleur du bouton. Si cette option 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 contrastée pour une meilleure lisibilité. Par exemple, si la couleur du bouton est définie sur bleu, tout texte ou icône du bouton est défini sur blanc. Pour définir la couleur du bouton, spécifiez une valeur pour les champs `red`, `green` et `blue`. La valeur doit être un nombre à virgule flottante compris entre 0 et 1, basé sur la valeur RVB de la couleur, où `0` (0/255) représente l'absence de couleur et `1` (255/255) représente l'intensité maximale de la couleur. Par exemple, la ligne suivante définit la couleur sur rouge à son intensité maximale : `"color": { "red": 1, "green": 0, "blue": 0, }` Le champ `alpha` n'est pas disponible pour la couleur du bouton. Si ce champ est spécifié, il est ignoré.
`on_click`	`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 à l'état inactif et ne répond pas aux actions de l'utilisateur.
`alt_text`	`string` Texte alternatif utilisé pour l'accessibilité. Définissez un texte descriptif qui indique aux utilisateurs ce que fait le bouton. Par exemple, si un bouton ouvre un lien hypertexte, vous pouvez écrire : "Ouvre un nouvel onglet de navigateur et accède à la documentation pour les développeurs Google Chat à l'adresse 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. Le type d'un bouton. Si le champ color est défini, type est défini sur FILLED.

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

Enums
`TYPE_UNSPECIFIED`	Ne pas utiliser. Non spécifié.
`OUTLINED`	Les boutons avec contours sont des boutons à emphase moyenne. Ils contiennent généralement des actions importantes, mais qui ne sont pas l'action principale d'une application ou d'un module complémentaire Chat.
`FILLED`	Un bouton rempli comporte un conteneur de couleur unie. Il a le plus d'impact visuel et est recommandé pour l'action importante et principale d'une application ou d'un module complémentaire Chat.
`FILLED_TONAL`	Un bouton tonal rempli est une alternative intermédiaire entre les boutons remplis et ceux avec un contour. Ils sont utiles dans les contextes où un bouton de priorité inférieure nécessite un peu plus d'emphase qu'un bouton de contour.
`BORDERLESS`	Un bouton ne doit pas avoir de conteneur invisible dans son état par défaut. Il est souvent utilisé pour les actions de priorité la plus basse, 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

Champs
`buttons[]`	`Button` Tableau de boutons.

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 cartes pour présenter des informations détaillées, collecter des informations auprès des utilisateurs et les guider vers l'étape suivante.

Concevez et prévisualisez des cartes avec le générateur de cartes.

Ouvrir le générateur de cartes

Pour savoir comment créer des cartes, 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. Tous les widgets au-delà de cette limite sont ignorés. Cette limite s'applique à la fois aux messages de carte et aux boîtes de dialogue dans les applications Google Chat, ainsi qu'aux cartes dans les modules complémentaires Google Workspace.

Exemple : Message de fiche pour une application Google Chat

Exemple de fiche de contact

Pour créer l'exemple de message de carte dans Google Chat, utilisez le 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": "sasha@example.com"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PERSON"
                   },
                   "text": "<font color=\"#80e27e\">Online</font>"
                 }
               },
               {
                 "decoratedText": {
                   "startIcon": {
                     "knownIcon": "PHONE"
                   },
                   "text": "+1 (555) 555-1234"
                 }
               },
               {
                 "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 carte. Un en-tête contient généralement une image 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. Pour obtenir un exemple dans les applications Google Chat, consultez Définir une section d'une fiche.
`section_divider_style`	`DividerStyle` Style du séparateur entre l'en-tête, les sections et le pied de page.
`card_actions[]`	`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, mais pas pour les applications Google Chat. Par exemple, le JSON suivant crée un menu d'actions de carte avec les options `Settings` et `Send Feedback` : `"card_actions": [ { "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 carte. Utilisé comme identifiant de carte dans la navigation par carte. Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.
`fixed_footer`	`CardFixedFooter` Pied de page fixe affiché en bas de cette fiche. Si vous définissez `fixedFooter` sans spécifier de `primaryButton` ni 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.
`display_style`	`DisplayStyle` Dans les modules complémentaires Google Workspace, définit les propriétés d'affichage de `peekCardHeader`. Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.
`peek_card_header`	`CardHeader` Lors de l'affichage de contenu contextuel, l'en-tête de la fiche d'aperçu sert d'espace réservé 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, mais pas 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, mais pas pour les applications Google Chat.

Champs

Champs
`action_label`	`string` Libellé qui s'affiche en tant qu'élément du menu d'actions.
`on_click`	`OnClick` Action `onClick` pour cet élément d'action.

action_label

string

Libellé qui s'affiche en tant qu'élément du menu d'actions.

on_click

OnClick

Action onClick pour cet élément d'action.

CardFixedFooter

Pied de page persistant qui s'affiche en bas de la fiche.

Si vous définissez fixedFooter sans spécifier de primaryButton ni 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

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

primary_button

Button

Bouton principal du pied de page fixe. Le bouton doit être un bouton de texte avec un texte et une couleur définis.

secondary_button

Button

Bouton secondaire du pied de page fixe. Le bouton doit être un bouton de texte avec un 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 carte. 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 carte. L'en-tête a une hauteur 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 elle est spécifiée, elle s'affiche sur sa propre ligne sous `title`.
`image_type`	`ImageType` Forme utilisée pour recadrer l'image. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.
`image_url`	`string` URL HTTPS de l'image dans l'en-tête de la carte.
`image_alt_text`	`string` Texte alternatif de cette image utilisé pour l'accessibilité.

DisplayStyle

Dans les modules complémentaires Google Workspace, détermine comment une fiche est affichée.

Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.

Enums
`DISPLAY_STYLE_UNSPECIFIED`	Ne pas utiliser. Non spécifié.
`PEEK`	L'en-tête de la fiche apparaît en bas de la barre latérale, recouvrant partiellement la fiche supérieure actuelle de la pile. Si vous cliquez sur l'en-tête, la fiche s'affiche dans la pile de fiches. Si la carte 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 carte. Actuellement utilisé uniquement pour les séparateurs entre les sections de cartes.

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. Afficher 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 est équivalent à l'absence de séparateur.

NestedWidget

Liste des widgets pouvant être affichés dans une mise en page de conteneur, telle qu'une CarouselCard.

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

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

Section

Une section contient un ensemble de widgets 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 mis en forme en 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 quels widgets sont masqués, spécifiez `uncollapsibleWidgetsCount`.
`uncollapsible_widgets_count`	`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. Le `uncollapsibleWidgetsCount` n'est pris en compte que lorsque `collapsible` est défini sur `true`.
`collapse_control`	`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

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

Par exemple, voici une représentation JSON d'un carrousel contenant trois widgets de paragraphe 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, mais pas pour les modules complémentaires Google Workspace.

Champs

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

carousel_cards[]

CarouselCard

Liste des cartes incluses dans le carrousel.

CarouselCard

Carte pouvant être affichée en tant qu'élément de carrousel.

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

Champs

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

widgets[]

NestedWidget

Liste des widgets affichés dans la fiche du carrousel. Les widgets s'affichent dans l'ordre dans lequel ils sont spécifiés.

footer_widgets[]

NestedWidget

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

Puce

Un 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 les deux paramètres `icon` et `text` sont définis, l'icône s'affiche avant le texte.
`label`	`string` Texte affiché dans le chip.
`on_click`	`OnClick` Facultatif. Action à effectuer lorsqu'un utilisateur clique sur le chip, comme l'ouverture d'un lien hypertexte ou l'exécution d'une fonction personnalisée.
`enabled (deprecated)`	`bool` Cet élément est obsolète. Indique si le chip est actif et répond aux actions de l'utilisateur. La valeur par défaut est `true`. Obsolète. Utilisez `disabled` à la place.
`disabled`	`bool` Indique si le chip est inactif et ignore les actions de l'utilisateur. La valeur par défaut est `false`.
`alt_text`	`string` Texte alternatif utilisé pour l'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 pour les développeurs Google Chat à l'adresse https://developers.google.com/workspace/chat".

ChipList

Liste de chips disposés horizontalement, qui peuvent défiler horizontalement ou passer à la ligne suivante.

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

Champs

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

layout

Layout

Mise en page de la liste de chips spécifiée.

chips[]

Chip

Tableau de chips.

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 tiennent pas dans l'espace disponible.

CollapseControl

Représente un contrôle de développement et de réduction.

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

Champs

Champs
`horizontal_alignment`	`HorizontalAlignment` Alignement horizontal du bouton de développement et de réduction.
`expand_button`	`Button` Facultatif. Définissez un bouton personnalisable pour développer la section. Les champs expand_button et collapse_button doivent être définis. Si vous ne définissez qu'un seul champ, il ne sera pas pris en compte. Si ce champ n'est pas défini, le bouton par défaut est utilisé.
`collapse_button`	`Button` Facultatif. Définissez un bouton personnalisable pour réduire la section. Les champs expand_button et collapse_button doivent être définis. Si vous ne définissez qu'un seul champ, il ne sera pas pris en compte. Si ce champ n'est pas défini, le bouton par défaut est utilisé.

horizontal_alignment

HorizontalAlignment

Alignement horizontal du bouton de développement et de réduction.

expand_button

Button

Facultatif. Définissez un bouton personnalisable pour développer la section. Les champs expand_button et collapse_button doivent être définis. Si vous ne définissez qu'un seul champ, il ne sera pas pris en compte. Si ce champ n'est pas défini, le bouton par défaut est utilisé.

collapse_button

Button

Facultatif. Définissez un bouton personnalisable pour réduire la section. Les champs expand_button et collapse_button doivent être définis. Si vous ne définissez qu'un seul champ, il ne sera pas pris en compte. 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 fiches 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 hauteur de la première. É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 passe sous la première :

Sur le Web, la deuxième colonne s'affiche sur plusieurs lignes si la largeur de l'écran est inférieure ou égale à 480 pixels.
Sur les appareils iOS, la deuxième colonne s'affiche sur plusieurs lignes si la largeur de l'écran est inférieure ou égale à 300 points.
Sur les appareils Android, la deuxième colonne s'affiche sur plusieurs lignes 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. Voici les UI de modules complémentaires qui sont compatibles avec les colonnes :

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 affichée lorsque les utilisateurs ouvrent le module complémentaire à partir du menu Ajouter une pièce jointe dans un événement Google Agenda.

Champs

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

column_items[]

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
`horizontal_size_style`	`HorizontalSizeStyle` Indique comment une colonne remplit la largeur de la carte.
`horizontal_alignment`	`HorizontalAlignment` Indique si les widgets sont alignés à gauche, à droite ou au centre d'une colonne.
`vertical_alignment`	`VerticalAlignment` Indique si les widgets sont 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 carte. 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, sans dépasser 30 % de la largeur de la fiche.

VerticalAlignment

Indique si les widgets sont 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`	Aligner 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 :
`text_paragraph`	`TextParagraph` Widget `TextParagraph`
`image`	`Image` Widget `Image`
`decorated_text`	`DecoratedText` Widget `DecoratedText`
`button_list`	`ButtonList` Widget `ButtonList`
`text_input`	`TextInput` Widget `TextInput`
`selection_input`	`SelectionInput` Widget `SelectionInput`
`date_time_picker`	`DateTimePicker` Widget `DateTimePicker`
`chip_list`	`ChipList` Widget `ChipList`

DateTimePicker

Permet aux utilisateurs de saisir une date, une heure ou les deux. Compatible avec la validation de l'envoi de formulaires. 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 choisir des dates et des heures. Si les utilisateurs saisissent une date ou une heure incorrectes, 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 le `DateTimePicker` 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.
`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.
`value_ms_epoch`	`int64` Valeur par défaut affichée dans le widget, en millisecondes depuis l'époque Unix. Spécifiez la valeur en fonction du type de sélecteur (`DateTimePickerType`) : `DATE_AND_TIME` : date et heure du calendrier 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`).
`timezone_offset_date`	`int32` Nombre représentant le décalage horaire par rapport à UTC, en minutes. Si cette option est définie, `value_ms_epoch` s'affiche dans le fuseau horaire spécifié. Si elle n'est pas définie, la valeur par défaut correspond au paramètre de fuseau horaire de l'utilisateur.
`on_change_action`	`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, comme 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. Obsolète, utilisez `startIcon`.
`start_icon`	`Icon` Icône affichée devant le texte.
`start_icon_vertical_alignment`	`VerticalAlignment` Facultatif. Alignement vertical de l'icône de début. Si ce paramètre n'est pas défini, l'icône sera centrée verticalement. Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités. Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.
`top_label`	`string` Texte qui s'affiche au-dessus de `text`. Toujours tronqué.
`top_label_text`	`TextParagraph` `TextParagraph` équivalent de `top_label`. Toujours tronqué. Permet une mise en forme plus complexe que `top_label`. Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités. Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.
`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.
`content_text`	`TextParagraph` `TextParagraph` équivalent de `text`. Permet une mise en forme plus complexe que `text`. Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités. Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.
`wrap_text`	`bool` Paramètre de retour à la ligne. Si la valeur est `true`, le texte est renvoyé à la ligne et s'affiche sur plusieurs lignes. Sinon, le texte est tronqué. S'applique uniquement à `text`, et non à `topLabel` et `bottomLabel`.
`bottom_label`	`string` Texte qui s'affiche sous `text`. Toujours en mode Wrap.
`bottom_label_text`	`TextParagraph` `TextParagraph` équivalent de `bottom_label`. Toujours en mode Wrap. Permet une mise en forme plus complexe que `bottom_label`. Version Preview pour les développeurs : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder de manière anticipée à certaines fonctionnalités. Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.
`on_click`	`OnClick` Cette action est déclenchée lorsque les utilisateurs cliquent sur `topLabel` ou `bottomLabel`.
Champ d'union `control`. Bouton, bouton bascule, 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.
`switch_control`	`SwitchControl` Widget de bouton bascule sur lequel un utilisateur peut cliquer pour modifier son état et déclencher une action.
`end_icon`	`Icon` Icône affichée après le texte. Compatible avec les icônes intégrées et personnalisées.

SwitchControl

Il s'agit d'un bouton bascule ou d'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 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` Lorsque `true`, le bouton bascule est sélectionné.
`on_change_action`	`Action` Action à effectuer lorsque l'état du commutateur est modifié, par exemple la fonction à exécuter.
`control_type`	`ControlType` Comment le bouton bascule s'affiche dans l'interface utilisateur. Disponible pour les applications Google Chat et les modules complémentaires Google Workspace.

ControlType

Comment le bouton bascule s'affiche dans l'interface utilisateur.

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

Enums
`SWITCH`	Un bouton bascule.
`CHECKBOX`	Obsolète, utilisez `CHECK_BOX`.
`CHECK_BOX`	Case à cocher.

Séparateur

Ce type ne comporte aucun champ.

Affiche une ligne horizontale pour séparer les widgets. Pour obtenir un exemple dans les applications Google Chat, consultez Ajouter un séparateur horizontal 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": {}

Grille

Affiche une grille avec une collection d'éléments. Les éléments ne peuvent inclure que du texte ou des images. Pour les colonnes responsives ou pour inclure plus que du texte ou des 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 contenir 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 2 colonnes comporte 5 lignes. Une grille comportant 11 éléments et 2 colonnes comporte 6 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.
`border_style`	`BorderStyle` Style de bordure à appliquer à chaque élément de la grille.
`column_count`	`int32` Nombre de colonnes à afficher dans la grille. Une valeur par défaut est utilisée si ce champ n'est pas spécifié. Cette valeur par défaut est différente selon l'endroit où la grille est affichée (dans une boîte de dialogue ou un emplacement associé).
`on_click`	`OnClick` Ce rappel est réutilisé par chaque élément de grille individuel, 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 grille.
`title`	`string` Titre de l'élément de grille.
`subtitle`	`string` Sous-titre de l'élément de 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 grille.
`TEXT_ABOVE`	Le titre et le sous-titre s'affichent au-dessus de l'image de l'élément de grille.

Icône

Icône affichée dans un widget sur une fiche. Pour obtenir 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
`alt_text`	`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. Nous vous recommandons de définir une description utile de ce que l'icône affiche et, le cas échéant, de ce qu'elle fait. 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`, le `altText` de l'icône est ignoré.
`image_type`	`ImageType` Style de recadrage appliqué à l'image. Dans certains cas, l'application d'un recadrage `CIRCLE` entraîne l'affichage de l'image à une taille supérieure à celle d'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 :
`known_icon`	`string` Affichez l'une des icônes intégrées fournies par Google Workspace. Par exemple, pour afficher une icône d'avion, spécifiez `AIRPLANE`. Pour un bus, spécifiez `BUS`. Pour obtenir la liste complète des icônes compatibles, consultez la page Icônes intégrées.
`icon_url`	`string` Affichez 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`.
`material_icon`	`MaterialIcon` Affichez l'une des icônes Material Design de Google. Par exemple, pour afficher une icône de case à cocher, utilisez `"material_icon": { "name": "check_box" }` Disponible pour les applications Google Chat, mais pas 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

Champs
`image_url`	`string` URL HTTPS qui héberge l'image. Exemple : `https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png`
`on_click`	`OnClick` Lorsqu'un utilisateur clique sur l'image, cette action est déclenchée.
`alt_text`	`string` Texte alternatif de cette image utilisé pour l'accessibilité.

image_url

string

URL HTTPS qui héberge l'image.

Exemple :

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

on_click

OnClick

Lorsqu'un utilisateur clique sur l'image, cette action est déclenchée.

alt_text

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
`image_uri`	`string` URL de l'image.
`alt_text`	`string` Libellé d'accessibilité de l'image.
`crop_style`	`ImageCropStyle` Style de recadrage à appliquer à l'image.
`border_style`	`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

Champs
`type`	`ImageCropType` Type de recadrage.
`aspect_ratio`	`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 }`

type

ImageCropType

Type de recadrage.

aspect_ratio

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.

MaterialIcon

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

Par exemple, pour afficher une icône de case à cocher avec un poids et une note personnalisés, saisissez ce qui suit :

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

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

Champs
`name`	`string` Nom de l'icône défini dans Google Material Icons, par exemple `check_box`. Tous les noms non valides sont abandonnés et remplacés par une chaîne vide, ce qui empêche l'icône de s'afficher.
`fill`	`bool` Indique si l'icône s'affiche en tant qu'icône pleine. La valeur par défaut est Faux (false). Pour prévisualiser différents paramètres d'icônes, accédez à Google Font Icons 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ônes, accédez à Google Font Icons 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 du niveau sont plus précis que ceux du poids et ont un impact mineur 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ônes, accédez à Google Font Icons et ajustez les paramètres sous Personnaliser.

OnClick

Représente la manière de répondre 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 une action est spécifiée, elle est déclenchée par ce `onClick`.
`open_link`	`OpenLink` Si cette `onClick` est spécifiée, elle déclenche une action d'ouverture de lien.
`open_dynamic_link_action`	`Action` Un module complémentaire déclenche cette action lorsqu'il doit ouvrir un lien. Cela diffère de `open_link` ci-dessus, car cela doit communiquer avec le serveur pour obtenir le lien. Par conséquent, le client Web doit effectuer des tâches préparatoires avant de recevoir la réponse à l'action d'ouverture du lien. Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.
`card`	`Card` Une nouvelle carte est ajoutée à la pile de cartes après un clic, si spécifié. Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.
`overflow_menu`	`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

Champs
`url`	`string` URL à ouvrir.
`open_as`	`OpenAs` Ouvrir un lien Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.
`on_close`	`OnClose` Que le client oublie un lien après l'avoir ouvert ou qu'il l'observe jusqu'à ce que la fenêtre se ferme. Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.

url

string

URL à ouvrir.

open_as

OpenAs

Ouvrir un lien

Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.

on_close

OnClose

Que le client oublie un lien après l'avoir ouvert ou qu'il l'observe jusqu'à ce que la fenêtre se ferme.

Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.

OnClose

Ce que fait le client lorsqu'un lien ouvert par une action OnClick est fermé.

L'implémentation dépend des capacité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 définis et que la plate-forme cliente ne peut pas prendre en charge les deux valeurs, OnClose est prioritaire.

Disponible pour les modules complémentaires Google Workspace, mais pas pour les applications Google Chat.

Enums

NOTHING Valeur par défaut. La carte ne se recharge pas et rien ne se passe.

Enums
`NOTHING`	Valeur par défaut. La carte ne se recharge pas et rien ne se passe.
`RELOAD`	Recharge la carte après la fermeture de la fenêtre enfant. Si elle est utilisée conjointement avec `OpenAs.OVERLAY`, la fenêtre enfant agit comme une boîte de dialogue modale et la carte parente est bloquée jusqu'à ce que la fenêtre enfant se ferme.

RELOAD

Recharge la carte après la fermeture de la fenêtre enfant.

Si elle est utilisée conjointement avec OpenAs.OVERLAY, la fenêtre enfant agit comme une boîte de dialogue modale et la carte parente est bloquée jusqu'à ce que la fenêtre enfant se ferme.

OpenAs

Lorsqu'une action OnClick ouvre un lien, le client peut l'ouvrir en tant que fenêtre en plein écran (s'il s'agit du frame utilisé par le client) ou en tant qu'overlay (tel qu'un pop-up). L'implémentation dépend des capacité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, mais pas pour les applications Google Chat.

Enums
`FULL_SIZE`	Le lien s'ouvre dans une fenêtre en plein écran (si tel est le cadre utilisé par le client).
`OVERLAY`	Le lien s'ouvre sous forme de superposition, comme un pop-up.

OverflowMenu

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

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

Champs

Champs
`items[]`	`OverflowMenuItem` Obligatoire. Liste des options de menu.

items[]

OverflowMenuItem

Obligatoire. Liste des options de 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
`start_icon`	`Icon` Icône affichée devant le texte.
`text`	`string` Obligatoire. Texte qui identifie ou décrit l'article aux utilisateurs.
`on_click`	`OnClick` Obligatoire. Action appelée lorsqu'une option de menu est sélectionnée. Ce `OnClick` ne peut pas contenir de `OverflowMenu`. Toute `OverflowMenu` spécifiée est supprimée 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".

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 abstraites ou non définies 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 l'entrée de 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 la 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 d'intervention 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 à cocher, 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 cases d'option ou de cases à cocher. Jusqu'à 100 éléments sont acceptés.
`on_change_action`	`Action` Si cette option est spécifiée, le formulaire est envoyé lorsque la sélection change. Si vous ne le faites pas, vous devez spécifier un bouton distinct pour envoyer le formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
`multi_select_max_selected_items`	`int32` Nombre maximal d'éléments qu'un utilisateur peut sélectionner dans les menus à sélection multiple. 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.
`multi_select_min_query_length`	`int32` Pour les menus à sélection multiple, il s'agit du nombre de caractères que l'utilisateur saisit avant que le menu ne renvoie des éléments de sélection suggérés. 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ère 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`), la valeur par défaut est de trois caractères avant d'interroger la source de données pour renvoyer les éléments suggérés.
Champ d'union `multi_select_data_source`. Pour un menu à sélection multiple, une source de données qui remplit dynamiquement les éléments de sélection. Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace. `multi_select_data_source` ne peut être qu'un des éléments suivants :
`external_data_source`	`Action` Une source de données externe, telle qu'une base de données relationnelle.
`platform_data_source`	`PlatformDataSource` Source de données provenant de Google Workspace.

PlatformDataSource

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

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

Champs

Champs
Champ d'union `data_source`. Source de données. `data_source` ne peut être qu'un des éléments suivants :
`common_data_source`	`CommonDataSource` Source de données partagée par toutes les applications Google Workspace, comme les utilisateurs d'une organisation Google Workspace.
`host_app_data_source`	`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.

Champ d'union data_source. Source de données. data_source ne peut être qu'un des éléments suivants :

common_data_source

CommonDataSource

Source de données partagée par toutes les applications Google Workspace, comme les utilisateurs d'une organisation Google Workspace.

host_app_data_source

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, mais pas pour les modules complémentaires Google Workspace.

Enums
`UNKNOWN`	Valeur par défaut. Ne pas utiliser.
`USER`	Utilisateurs Google Workspace. L'utilisateur ne peut afficher et sélectionner que les 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 bascule. Jusqu'à 100 éléments sont acceptés.

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

Champs
`text`	`string` Texte qui identifie ou décrit l'article aux 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 saisie de sélection n'accepte qu'une seule valeur (comme pour les boutons radio ou un menu déroulant), ne définissez ce champ que pour un seul élément.
`bottom_text`	`string` Pour les menus à sélection multiple, il s'agit d'une description textuelle ou d'un libellé affiché sous le champ `text` de l'élément.
Champ d'union `start_icon`. Pour les menus à sélection multiple, il s'agit de l'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`. `start_icon` ne peut être qu'un des éléments suivants :
`start_icon_uri`	`string`

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 entrée de sélection est compatible avec un seul type de sélection. Par exemple, il n'est pas possible de mélanger des cases à cocher et des boutons bascule.

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 case d'option.
`SWITCH`	Un ensemble de commutateurs. Les utilisateurs peuvent activer un ou plusieurs commutateurs.
`DROPDOWN`	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 et sélectionner un ou plusieurs éléments. Pour les modules complémentaires Google Workspace, vous devez remplir les éléments à l'aide d'un tableau statique d'objets `SelectionItem`. Pour les applications Google Chat, vous pouvez également remplir 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 suggère automatiquement l'espace. Pour remplir 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 des données Google Workspace, comme 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 obtenir des exemples d'implémentation de 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.

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 est filtrée 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. Les suggestions JavaScript peuvent standardiser la façon dont les utilisateurs interagissent avec votre application.

Lorsqu'il est spécifié, TextInput.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.

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 entrée suggérée dans un champ de saisie de texte. Cela équivaut à 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 de modification. Compatible avec la validation de l'envoi de formulaires. 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 de chat reçoivent et peuvent traiter la valeur du texte saisi lors des événements de saisie 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 abstraites ou non définies auprès des utilisateurs, utilisez une entrée 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 l'entrée de texte est identifiée 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 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, écrivez `surname` au lieu de `name`. Obligatoire si `hintText` n'est pas spécifié. Sinon, facultatif.
`hint_text`	`string` Texte qui s'affiche sous le champ de saisie de texte et qui est destiné à aider les utilisateurs en les invitant à saisir une certaine valeur. 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 d'entrée de formulaire. Pour en savoir plus sur l'utilisation des entrées de formulaire, consultez Recevoir des données de formulaire.
`type`	`Type` Apparence d'un champ de saisie de texte dans l'interface utilisateur. Par exemple, si le champ est sur une ou plusieurs lignes.
`on_change_action`	`Action` Que faire lorsqu'une modification 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.
`initial_suggestions`	`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 est filtrée 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`. Les suggestions `JavaScript` peuvent standardiser la façon dont les utilisateurs interagissent avec votre application. Lorsqu'il est spécifié, `TextInput.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.
`auto_complete_action`	`Action` Facultatif. Spécifiez l'action à effectuer lorsque le champ de saisie de texte fournit des suggestions aux utilisateurs qui interagissent avec lui. Si aucune valeur n'est 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, comme l'exécution d'une fonction personnalisée. Disponible pour les modules complémentaires Google Workspace, mais pas 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.
`placeholder_text`	`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, mais pas pour les modules complémentaires Google Workspace.

Type

Apparence d'un champ de saisie de texte dans l'interface utilisateur. Par exemple, s'il s'agit d'un champ de saisie d'une 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`	La hauteur du champ de saisie de texte est fixe et correspond à 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.

max_lines

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é, le bouton Afficher plus ne s'affiche pas.

La valeur par défaut est 0, auquel cas tout le contexte est affiché. Les valeurs négatives sont ignorées.

text_syntax

TextSyntax

Syntaxe du texte. Si ce paramètre n'est pas défini, le texte est affiché au format HTML.

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

TextSyntax

Syntaxe à utiliser pour mettre en forme le texte.

Disponible pour les applications Google Chat, mais pas pour les modules complémentaires Google Workspace.

Enums
`TEXT_SYNTAX_UNSPECIFIED`	Si aucune valeur n'est spécifiée, le texte est affiché au format HTML.
`HTML`	Le texte est affiché au format HTML. Il s'agit de la valeur par défaut.
`MARKDOWN`	Le texte est rendu au format Markdown.

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

character_limit

int32

Spécifiez le nombre maximal 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.

input_type

InputType

Spécifiez le type des widgets d'entrée.

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

InputType

Type du widget d'entrée.

Enums
`INPUT_TYPE_UNSPECIFIED`	Type non spécifié. Ne pas utiliser.
`TEXT`	Texte normal 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.

Champs
`horizontal_alignment`	`HorizontalAlignment` Indique si les widgets sont 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 :
`text_paragraph`	`TextParagraph` Affiche un paragraphe de texte. Compatible avec le texte mis en forme en 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 un texte alternatif : `"image": { "imageUrl": "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png", "altText": "Chat app avatar" }`
`decorated_text`	`DecoratedText` Affiche un élément de texte décoré. Par exemple, le JSON suivant crée un widget de texte enrichi affichant une adresse e-mail : `"decoratedText": { "icon": { "knownIcon": "EMAIL" }, "topLabel": "Email Address", "text": "sasha@example.com", "bottomLabel": "This is a new Email address!", "switchControl": { "name": "has_send_welcome_email_to_sasha", "selected": false, "controlType": "CHECKBOX" } }`
`button_list`	`ButtonList` Liste de 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 d'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" } } } ] }`
`text_input`	`TextInput` Affiche une zone de texte dans laquelle les utilisateurs peuvent saisir du texte. Par exemple, le code JSON suivant crée une entrée de texte pour une adresse e-mail : `"textInput": { "name": "mailing_address", "label": "Mailing Address" }` Voici un autre 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" } ] } }`
`selection_input`	`SelectionInput` Affiche un contrôle de sélection qui permet 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 } ] }`
`date_time_picker`	`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 contenir un nombre illimité de colonnes et d'éléments. Le nombre de lignes est déterminé par les limites supérieures du nombre d'éléments divisé par le nombre de colonnes. Une grille de 10 éléments et 2 colonnes comporte 5 lignes. Une grille comportant 11 éléments et 2 colonnes comporte 6 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 une collection de widgets imbriqués. Par exemple, voici la 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." } } ] }`
`chip_list`	`ChipList` Liste de 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

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, l'alignement se fait à gauche. Pour les mises en page de droite à gauche, l'alignement se fait à droite.
`CENTER`	Aligne les widgets au centre de la colonne.
`END`	Aligner les widgets sur la position de 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

Enums
`SQUARE`	Valeur par défaut. Applique un masque carré à l'image. Par exemple, une image 4x3 devient une image 3x3.
`CIRCLE`	Applique un masque circulaire à l'image. Par exemple, une image au format 4:3 devient un cercle de diamètre 3.

VerticalAlignment

Enums
`VERTICAL_ALIGNMENT_UNSPECIFIED`	Type non spécifié. Ne pas utiliser.
`TOP`	Alignement en haut.
`MIDDLE`	Alignement sur la position du milieu.
`BOTTOM`	Alignement en bas.

Package google.apps.card.v1 Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Index

Action

ActionParameter

Interaction

LoadIndicator

BorderStyle

BorderType

Bouton

Type

ButtonList

Fiche

CardAction

CardFixedFooter

CardHeader

DisplayStyle

DividerStyle

NestedWidget

Section

Carrousel

CarouselCard

Puce

ChipList

Mise en page

CollapseControl

Colonnes

Colonne

HorizontalSizeStyle

VerticalAlignment

Widgets

DateTimePicker

DateTimePickerType

DecoratedText

SwitchControl

ControlType

Séparateur

Grille

GridItem

GridItemLayout

Icône

Image

ImageComponent

ImageCropStyle

ImageCropType

MaterialIcon

OnClick

OpenLink

OnClose

OpenAs

OverflowMenu

OverflowMenuItem

SelectionInput

PlatformDataSource

CommonDataSource

SelectionItem

SelectionType

Suggestions

SuggestionItem

TextInput

Type

TextParagraph

TextSyntax

Validation

InputType

Widget

HorizontalAlignment

ImageType

VerticalAlignment

Package google.apps.card.v1