Icon

Ikona wyświetlana w widżecie na karcie. Przykład dotyczący aplikacji Google Chat znajdziesz w sekcji Dodawanie ikony.

Obsługuje ikony wbudowane i niestandardowe.

Dostępne w przypadku aplikacji do Google Chat i dodatków do Google Workspace.

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

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

string

Opcjonalnie. Opis ikony używany na potrzeby ułatwień dostępu. Jeśli nie określono inaczej, zostanie użyta domyślna wartość Button. Zgodnie ze sprawdzonymi metodami warto ustawić przydatny opis tego, co wyświetla ikona i co robi (jeśli dotyczy). na przykład A user's account portrait lub Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

Jeśli ikona jest ustawiona w elemencie Button, altText pojawia się jako tekst pomocniczy, gdy użytkownik najedzie kursorem na przycisk. Jeśli jednak przycisk ustawia też text, wartość altText ikony jest ignorowana.

imageType

enum (ImageType)

Styl przycięcia zastosowany do obrazu. W niektórych przypadkach zastosowanie przycięcia CIRCLE powoduje, że obraz jest większy niż wbudowana ikona.

Ikona wyświetlana w widżecie na karcie. Poniżej znajduje się lista pól, które wzajemnie się wykluczają. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
knownIcon

string

wyświetlić jedną z wbudowanych ikon udostępnianych przez Google Workspace,

Aby na przykład wyświetlić ikonę samolotu, wpisz AIRPLANE. W przypadku autobusu podaj BUS.

Pełną listę obsługiwanych ikon znajdziesz w sekcji Wbudowane ikony.

iconUrl

string

Wyświetl ikonę niestandardową hostowaną pod adresem URL HTTPS.

Na przykład:

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

Obsługiwane typy plików to .png i .jpg.

materialIcon

object (MaterialIcon)

Wyświetl jedną z ikon w stylu Material Design.

Aby na przykład wyświetlić ikonę pola wyboru, użyj:

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

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.

Koniec pól wykluczających się wzajemnie.

MaterialIcon

Ikona w stylu Material Design, która obejmuje ponad 2500 opcji.

Aby na przykład wyświetlić ikonę pola wyboru o niestandardowej grubości i klasie, wpisz:

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

 Dostępne w przypadku aplikacji do Google Chat i niedostępne w przypadku dodatków do Google Workspace.

Zapis JSON
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Pola
name

string

Nazwa ikony zdefiniowana w ikonach w stylu Material Design, np. check_box. Nieprawidłowe nazwy są odrzucane i zastępowane pustym ciągiem znaków, co powoduje, że ikona nie jest renderowana.

fill

boolean

Określa, czy ikona ma być wypełniona. Wartość domyślna to false (fałsz).

Aby wyświetlić podgląd różnych ustawień ikon, wejdź na stronę Google Font Icons i dostosuj ustawienia w sekcji Customize (Dostosuj).

weight

integer

Grubość konturu ikony. Wybierz jedną z tych wartości: {100, 200, 300, 400, 500, 600, 700}. Jeśli nie zostanie podana, domyślna wartość to 400. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

Aby wyświetlić podgląd różnych ustawień ikon, wejdź na stronę Google Font Icons i dostosuj ustawienia w sekcji Customize (Dostosuj).

grade

integer

Waga i stopień wpływają na grubość symbolu. Dostosowania stopnia są bardziej szczegółowe niż dostosowania wagi i mają niewielki wpływ na rozmiar symbolu. Wybierz spośród {-25, 0, 200}. Jeśli nie zostanie podana, domyślna wartość to 0. Jeśli podasz inną wartość, zostanie użyta wartość domyślna.

Aby wyświetlić podgląd różnych ustawień ikon, wejdź na stronę Google Font Icons i dostosuj ustawienia w sekcji Customize (Dostosuj).