Icône

Le widget Icon représente une icône intégrée ou une icône personnalisée. Vous pouvez utiliser Icon dans les messages associés à une fiche et les boîtes de dialogue de différentes manières:

  • Afficher une icône autonome.
  • Afficher une icône devant le texte associé, dans un widget DecoratedText.
  • Afficher une icône sous la forme d'un bouton interactif dans un widget ButtonList


Créez et prévisualisez des fiches avec Card Builder.

Ouvrez l'outil de création de cartes

Voici une fiche composée d'un composant Icon:

Icônes intégrées disponibles pour le widget Icon

Pour utiliser une icône intégrée, utilisez le champ knownIcon:

{
  .
  .
  .
      "knownIcon": "TRAIN",
  .
  .
  .
}

Le tableau suivant liste les icônes intégrées disponibles pour les messages avec fiche:

Avion BOOKMARK
BUS VOITURE
Horloge CONFIRMATION_NUMBER_ICON
DESCRIPTION DOLLAR
E-MAIL EVENT_SEAT
FLIGHT_ARRIVAL FLIGHT_DEPARTURE
HÔTEL HOTEL_ROOM_TYPE
INVITATION MAP_PIN
SOUSCRIPTION MULTIPLE_PEOPLE
PERSONNE TÉLÉPHONE
RESTAURANT_ICON SHOPPING_CART
AJOUTER AUX FAVORIS BOUTIQUE
BILLET TRAIN
VIDEO_CAMERA VIDEO_PLAY

Représentation et champs JSON

Représentation JSON
{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string
  // End of list of possible types for union field icons.
}
Champs
altText

string

Facultatif. Description de l'icône utilisée pour l'accessibilité. Si aucune valeur n'est spécifiée, la valeur par défaut Button est fournie. Une bonne pratique consiste à 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/chat.

Si l'icône est définie dans un Button, l'altText apparaît 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é.

imageType

enum (ImageType)

Style de recadrage appliqué à l'image. Dans certains cas, si vous appliquez un recadrage CIRCLE, l'image sera plus grande qu'une icône intégrée.

Champ d'union icons. Icône affichée dans le widget sur la fiche. icons ne peut être que l'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 représentant un 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/chat/images/quickstart-app-avatar.png"

Les types de fichiers .png et .jpg sont compatibles.

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 devient un cercle d'un diamètre de 3.

Dépannage

Lorsqu'une application ou une fiche Google Chat renvoie une erreur, l'interface Chat affiche un message indiquant "Un problème est survenu" ou "Impossible de traiter votre demande". Il peut arriver que l'interface Chat n'affiche aucun message d'erreur, mais que l'application ou la fiche Chat génère un résultat inattendu. Par exemple, il est possible qu'un message de fiche ne s'affiche pas.

Bien qu'aucun message d'erreur ne s'affiche dans l'interface Chat, des messages d'erreur descriptifs et des données de journal sont disponibles pour vous aider à corriger les erreurs lorsque la journalisation des erreurs est activée pour les applications Chat. Si vous avez besoin d'aide pour afficher, déboguer et corriger les erreurs, consultez Résoudre les erreurs Google Chat.