Icon

Ein Symbol, das in einem Widget auf einer Karte angezeigt wird. Ein Beispiel für Google Chat-Apps finden Sie unter Symbol hinzufügen.

Unterstützt integrierte und benutzerdefinierte Symbole.

Verfügbar für Google Chat-Apps und Google Workspace-Add-ons.

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

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

string

Optional. Eine Beschreibung des Symbols, die als Bedienungshilfe verwendet wird. Wenn kein Wert angegeben ist, wird der Standardwert Button verwendet. Als Best Practice sollten Sie eine hilfreiche Beschreibung dafür festlegen, was das Symbol darstellt und gegebenenfalls, was es tut. Beispiel: A user's account portrait oder Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat.

Wenn das Symbol in einem Button festgelegt ist, wird der altText als Hilfetext angezeigt, wenn der Nutzer den Mauszeiger auf die Schaltfläche bewegt. Wenn für die Schaltfläche jedoch auch text festgelegt ist, wird die altText des Symbols ignoriert.
imageType

enum (ImageType)

Der auf das Bild angewendete Zuschneidestil. In einigen Fällen wird das Bild durch das Zuschneiden mit CIRCLE größer dargestellt als ein integriertes Symbol.
Das Symbol, das im Widget auf der Karte angezeigt wird. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
knownIcon

string

Eines der integrierten Symbole von Google Workspace anzeigen.

Wenn Sie beispielsweise ein Flugzeugsymbol anzeigen möchten, geben Sie AIRPLANE an. Geben Sie für einen Bus BUS an.

Eine vollständige Liste der unterstützten Symbole finden Sie unter Integrierte Symbole.
iconUrl

string

Ein benutzerdefiniertes Symbol anzeigen, das unter einer HTTPS-URL gehostet wird.

Beispiel:

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

Zu den unterstützten Dateitypen gehören .png und .jpg.
materialIcon

object (MaterialIcon)

Eines der Google Material Design-Symbole anzeigen.

Wenn Sie beispielsweise ein Kästchensymbol anzeigen möchten, verwenden Sie Folgendes:

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

Verfügbar für Google Chat-Apps und nicht verfügbar für Google Workspace-Add-ons.
Ende der sich gegenseitig ausschließenden Felder.

MaterialIcon

Ein Google Material Design-Symbol, das über 2.500 Optionen umfasst.

Wenn Sie beispielsweise ein Kästchensymbol mit benutzerdefinierter Strichstärke und benutzerdefiniertem Grad anzeigen möchten, schreiben Sie Folgendes:

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

Verfügbar für Google Chat-Apps und nicht verfügbar für Google Workspace-Add-ons.

JSON-Darstellung 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
Felder
name

string

Der Symbolname, der im Google Material Design-Symbol definiert ist, z. B. check_box. Ungültige Namen werden verworfen und durch einen leeren String ersetzt. Das Symbol wird dann nicht gerendert.
fill

boolean

Gibt an, ob das Symbol ausgefüllt dargestellt wird. Der Standardwert ist "false".

Wenn Sie sich eine Vorschau verschiedener Symboleinstellungen ansehen möchten, rufen Sie Google Font Icons auf und passen Sie die Einstellungen unter Anpassen an.
weight

integer

Die Strichstärke des Symbols. Wählen Sie einen Wert aus {100, 200, 300, 400, 500, 600, 700}. Wenn nicht vorhanden, ist der Standardwert 400. Wenn ein anderer Wert angegeben wird, wird der Standardwert verwendet.

Wenn Sie sich eine Vorschau verschiedener Symboleinstellungen ansehen möchten, rufen Sie Google Font Icons auf und passen Sie die Einstellungen unter Anpassen an.
grade

integer

Gewicht und Grad beeinflussen die Stärke eines Symbols. Anpassungen der Stärke sind detaillierter als Anpassungen der Breite und haben nur geringe Auswirkungen auf die Größe des Symbols. Wählen Sie einen Wert aus {-25, 0, 200}. Wenn nicht vorhanden, ist der Standardwert 0. Wenn ein anderer Wert angegeben wird, wird der Standardwert verwendet.

Wenn Sie sich eine Vorschau verschiedener Symboleinstellungen ansehen möchten, rufen Sie Google Font Icons auf und passen Sie die Einstellungen unter Anpassen an.