Icon

Um ícone exibido em um widget em um card. Para ver um exemplo em apps do Google Chat, consulte Adicionar um ícone.

Compatível com ícones integrados e personalizados.

Disponível para apps do Google Chat e complementos do Google Workspace.

Representação JSON 
{
  "altText": string,
  "imageType": enum (ImageType),

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

string

Opcional. Uma descrição do ícone usado para acessibilidade. Se não for especificado, o valor padrão Button será fornecido. Como prática recomendada, defina uma descrição útil para o que o ícone mostra e, se aplicável, o que ele faz. Por exemplo, 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.

Se o ícone estiver definido em um Button, o altText vai aparecer como texto de ajuda quando o usuário passar o cursor sobre o botão. No entanto, se o botão também definir text, o altText do ícone será ignorado.
imageType

enum (ImageType)

O estilo de corte aplicado à imagem. Em alguns casos, aplicar um corte CIRCLE faz com que a imagem seja desenhada maior do que um ícone integrado.
O ícone exibido no widget do card. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta:
knownIcon

string

Mostre um dos ícones integrados fornecidos pelo Google Workspace.

Por exemplo, para mostrar um ícone de avião, especifique AIRPLANE. Para um barramento, especifique BUS.

Para ver uma lista completa de ícones compatíveis, consulte ícones integrados.
iconUrl

string

Mostre um ícone personalizado hospedado em um URL HTTPS.

Exemplo:

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

Os tipos de arquivo aceitos incluem .png e .jpg.
materialIcon

object (MaterialIcon)

Mostre um dos ícones do Material Design do Google.

Por exemplo, para mostrar um ícone de caixa de seleção, use

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

Disponível para apps do Google Chat e indisponível para complementos do Google Workspace.
Fim dos campos mutuamente exclusivos.

MaterialIcon

Um ícone do Material Design do Google, que inclui mais de 2.500 opções.

Por exemplo, para mostrar um ícone de caixa de seleção com peso e grau personalizados, escreva o seguinte:

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

Disponível para apps do Google Chat e indisponível para complementos do Google Workspace.

Representação JSON 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Campos
name

string

O nome do ícone definido no ícone do Google Material Design, por exemplo, check_box. Os nomes inválidos são abandonados e substituídos por uma string vazia, o que resulta na falha de renderização do ícone.
fill

boolean

Se o ícone é renderizado como preenchido. O valor padrão é falso.

Para conferir as diferentes configurações de ícones, acesse Ícones do Google Fonts e ajuste as configurações em Personalizar.
weight

integer

A espessura do traço do ícone. Escolha entre {100, 200, 300, 400, 500, 600, 700}. Se ausente, o valor padrão é 400. Se qualquer outro valor for especificado, o valor padrão será usado.

Para conferir as diferentes configurações de ícones, acesse Ícones do Google Fonts e ajuste as configurações em Personalizar.
grade

integer

O peso e a gradação afetam a espessura de um símbolo. Os ajustes de gradação são mais detalhados do que os de peso e têm um impacto pequeno no tamanho do símbolo. Escolha entre {-25, 0, 200}. Se ausente, o valor padrão é 0. Se qualquer outro valor for especificado, o valor padrão será usado.

Para conferir as diferentes configurações de ícones, acesse Ícones do Google Fonts e ajuste as configurações em Personalizar.