Icon

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.

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

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
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. 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é.
imageType

enum (ImageType)

Style de recadrage appliqué à l'image. Dans certains cas, l'application d'un recadrage CIRCLE entraîne l'affichage d'une image plus grande qu'une icône intégrée.
Icône affichée dans le widget sur la fiche. Voici une liste de champs mutuellement exclusifs. Au maximum, un des champs sera défini dans une réponse :
knownIcon

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 Icônes intégrées.
iconUrl

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.
materialIcon

object (MaterialIcon)

Affichez l'une des icônes Material de Google.

Par exemple, pour afficher une icône de case à cocher, utilisez :

"materialIcon": {
  "name": "check_box"
}

 Disponible pour les applications Google Chat et non disponible pour les modules complémentaires Google Workspace.
Fin des champs mutuellement exclusifs.

MaterialIcon

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

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

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

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

Représentation JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Champs
name

string

Nom de l'icône défini dans l'icône Material de Google, par exemple check_box. 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

boolean

Indique si l'icône s'affiche comme remplie. 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 Customize (Personnaliser).
weight

integer

Épaisseur du trait de l'icône. Choisissez l'une des valeurs suivantes : {100, 200, 300, 400, 500, 600, 700}. Si elle n'est pas spécifiée, 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 Customize (Personnaliser).
grade

integer

L'épaisseur et le niveau ont une incidence sur l'épaisseur d'un symbole. Les ajustements du niveau sont plus précis que ceux de l'épaisseur et ont un faible impact sur la taille du symbole. Choisissez une valeur 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 Customize (Personnaliser).