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 자르기를 적용하면 이미지가 내장 아이콘보다 크게 그려집니다.
카드의 위젯에 표시되는 아이콘입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
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

2,500개 이상의 옵션이 포함된 Google 머티리얼 아이콘

예를 들어 맞춤설정된 두께와 등급으로 체크박스 아이콘을 표시하려면 다음과 같이 작성합니다.

{
  "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 Material 아이콘에 정의된 아이콘 이름입니다(예: check_box). 잘못된 이름은 삭제되고 빈 문자열로 대체되며 아이콘이 렌더링되지 않습니다.
fill

boolean

아이콘이 채워진 상태로 렌더링되는지 여부입니다. 기본값은 false입니다.

다양한 아이콘 설정을 미리 보려면 Google Fonts 아이콘으로 이동하여 맞춤설정에서 설정을 조정합니다.
weight

integer

아이콘의 획 두께입니다. {100, 200, 300, 400, 500, 600, 700} 중에서 선택합니다. 없으면 기본값은 400입니다. 다른 값이 지정되면 기본값이 사용됩니다.

다양한 아이콘 설정을 미리 보려면 Google Fonts 아이콘으로 이동하여 맞춤설정에서 설정을 조정합니다.
grade

integer

두께와 등급은 기호의 두께에 영향을 미칩니다. 등급 조정은 두께 조정보다 더 세분화되며 기호 크기에 미치는 영향이 적습니다. {-25, 0, 200} 중에서 선택하세요. 값이 없으면 기본값은 0입니다. 다른 값이 지정되면 기본값이 사용됩니다.

다양한 아이콘 설정을 미리 보려면 Google Fonts 아이콘으로 이동하여 맞춤설정에서 설정을 조정합니다.