Icon

Un'icona visualizzata in un widget su una scheda. Per un esempio nelle app Google Chat, consulta Aggiungi un'icona.

Supporta icone integrate e personalizzate.

Disponibile per le app di Google Chat e i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
Campi
altText

string

Facoltativo. Una descrizione dell'icona utilizzata per l'accessibilità. Se non viene specificato, viene fornito il valore predefinito Button. Come best practice, devi impostare una descrizione utile di ciò che l'icona mostra e, se applicabile, di ciò che fa. Ad esempio, A user's account portrait o Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

Se l'icona è impostata in un Button, altText viene visualizzato come testo di aiuto quando l'utente passa il mouse sopra il pulsante. Tuttavia, se il pulsante imposta anche text, l'icona altText viene ignorata.
imageType

enum (ImageType)

Lo stile di ritaglio applicato all'immagine. In alcuni casi, l'applicazione di un ritaglio CIRCLE fa sì che l'immagine venga disegnata più grande di un'icona integrata.
L'icona visualizzata nel widget della scheda. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
knownIcon

string

Visualizza una delle icone integrate fornite da Google Workspace.

Ad esempio, per visualizzare l'icona di un aereo, specifica AIRPLANE. Per un autobus, specifica BUS.

Per un elenco completo delle icone supportate, consulta l'elenco delle icone integrate.
iconUrl

string

Visualizza un'icona personalizzata ospitata su un URL HTTPS.

Ad esempio:

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

I tipi di file supportati includono .png e .jpg.
materialIcon

object (MaterialIcon)

Mostra una delle icone Material di Google.

Ad esempio, per visualizzare un'icona di casella di controllo, utilizza

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

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.
Fine dei campi che si escludono a vicenda.

MaterialIcon

Un'icona Material, che include oltre 2500 opzioni.

Ad esempio, per visualizzare un'icona di casella di controllo con spessore e grado personalizzati, scrivi quanto segue:

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

Disponibile per le app Google Chat e non disponibile per i componenti aggiuntivi di Google Workspace.

Rappresentazione JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Campi
name

string

Il nome dell'icona definito nell'icona Material di Google, ad esempio check_box. I nomi non validi vengono abbandonati e sostituiti con una stringa vuota, il che impedisce il rendering dell'icona.
fill

boolean

Indica se l'icona viene visualizzata come piena. Il valore predefinito è false.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Google Font Icons e regola le impostazioni in Personalizza.
weight

integer

Lo spessore del tratto dell'icona. Scegli tra {100, 200, 300, 400, 500, 600, 700}. Se assente, il valore predefinito è 400. Se viene specificato un altro valore, viene utilizzato il valore predefinito.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Google Font Icons e modifica le impostazioni in Personalizza.
grade

integer

Lo spessore e il grado influiscono sullo spessore di un simbolo. Le regolazioni del grado sono più granulari di quelle del peso e hanno un impatto ridotto sulle dimensioni del simbolo. Scegli tra {-25, 0, 200}. Se non è presente, il valore predefinito è 0. Se viene specificato un altro valore, viene utilizzato il valore predefinito.

Per visualizzare l'anteprima di diverse impostazioni delle icone, vai a Google Font Icons e modifica le impostazioni in Personalizza.