Icon

カードのウィジェットに表示されるアイコン。Google Chat 用アプリの例については、アイコンを追加するをご覧ください。

組み込みアイコンとカスタム アイコンをサポートしています。

Google Chat アプリと Google Workspace アドオンで使用できます。

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

  "knownIcon": string,
  "iconUrl": string,
  "materialIcon": {
    object (MaterialIcon)
  }
}
フィールド
altText

string

省略可。アクセシビリティに使用されるアイコンの説明。指定しない場合は、デフォルト値 Button が使用されます。アイコンが表示する内容と、該当する場合はアイコンの機能について、わかりやすい説明を設定することをおすすめします。例: A user's account portrait、または Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/workspace/chat。

アイコンが Button に設定されている場合、ユーザーがボタンにカーソルを合わせると、altText がヘルパー テキストとして表示されます。ただし、ボタンに text も設定されている場合、アイコンの altText は無視されます。
imageType

enum (ImageType)

画像に適用される切り抜きスタイル。場合によっては、CIRCLE 切り抜きを適用すると、画像が組み込みアイコンよりも大きく描画されることがあります。
カードのウィジェットに表示されるアイコン。相互に排他的なフィールドのリストは次のとおりです。レスポンスに設定されるフィールドは、最大 1 つです。
knownIcon

string

Google Workspace に用意されている組み込みアイコンのいずれかを表示します。

たとえば、飛行機のアイコンを表示するには、AIRPLANE を指定します。バスの場合は、BUS を指定します。

サポートされているアイコンの一覧については、組み込みアイコンをご覧ください。
iconUrl

string

HTTPS URL でホストされているカスタム アイコンを表示する。

次に例を示します。

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

サポートされているファイル形式は .png と .jpg です。
materialIcon

object (MaterialIcon)

Google マテリアル アイコンのいずれかを表示します。

たとえば、チェックボックス アイコンを表示するには、

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

Google Chat アプリで使用可能、Google Workspace アドオンでは使用不可。
相互に排他的なフィールドの終了。

MaterialIcon

Google マテリアル アイコン。2,500 以上のオプションが含まれています。

たとえば、太さとグレードをカスタマイズしたチェックボックス アイコンを表示するには、次のように記述します。

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

Google Chat アプリで使用可能、Google Workspace アドオンでは使用不可。

JSON 表現 
{
  "name": string,
  "fill": boolean,
  "weight": integer,
  "grade": integer
}
フィールド
name

string

Google マテリアル アイコンで定義されているアイコン名（例: check_box）。無効な名前は破棄され、空の文字列に置き換えられます。その結果、アイコンはレンダリングされません。
fill

boolean

アイコンを塗りつぶしてレンダリングするかどうか。デフォルト値は false です。

さまざまなアイコン設定をプレビューするには、Google Font Icons に移動し、[Customize] で設定を調整します。
weight

integer

アイコンのストロークの太さ。{100、200、300、400、500、600、700} から選択します。指定しない場合、デフォルト値は 400 です。他の値が指定されている場合は、デフォルト値が使用されます。

さまざまなアイコン設定をプレビューするには、Google Font Icons に移動し、[Customize] で設定を調整します。
grade

integer

ウェイトとグレードはシンボルの太さに影響します。グレードの調整はウェイトの調整よりもきめ細かく、シンボルのサイズに与える影響は小さくなります。{-25, 0, 200} から選択します。指定しない場合、デフォルト値は 0 です。他の値が指定されている場合は、デフォルト値が使用されます。

さまざまなアイコン設定をプレビューするには、Google Font Icons に移動し、[Customize] で設定を調整します。