Button

사용자가 클릭할 수 있는 텍스트, 아이콘 또는 텍스트 및 아이콘 버튼입니다. Google Chat 앱의 예시는 버튼 추가를 참고하세요.

이미지를 클릭 가능한 버튼으로 만들려면 Image(ImageComponent 아님)를 지정하고 onClick 작업을 설정합니다.

Google Chat 앱 및 Google Workspace 부가기능에 사용할 수 있습니다.

JSON 표현 
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string,
  "type": enum (Type)
}
필드
text

string

버튼 내부에 표시되는 텍스트입니다.
icon

object (Icon)

버튼 내부에 표시되는 아이콘입니다. icon와 text가 모두 설정된 경우 아이콘이 텍스트 앞에 표시됩니다.
color

object (Color)

선택사항입니다. 버튼의 색상입니다. 설정하면 버튼 type가 FILLED로 설정되고 text 및 icon 필드의 색상이 가독성을 위해 대비되는 색상으로 설정됩니다. 예를 들어 버튼 색상이 파란색으로 설정되면 버튼의 모든 텍스트나 아이콘은 흰색으로 설정됩니다.

버튼 색상을 설정하려면 red, green, blue 필드의 값을 지정합니다. 값은 RGB 색상 값을 기준으로 0과 1 사이의 부동 소수점 수여야 합니다. 여기서 0(0/255)은 색상이 없음을 나타내고 1(255/255)은 색상의 최대 강도를 나타냅니다.

예를 들어 다음은 색상을 최대 강도의 빨간색으로 설정합니다.

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
}

버튼 색상에 alpha 필드를 사용할 수 없습니다. 지정된 경우 이 필드는 무시됩니다.
onClick

object (OnClick)

필수 항목입니다. 사용자가 버튼을 클릭할 때 실행할 작업입니다(예: 하이퍼링크 열기 또는 맞춤 함수 실행).
disabled

boolean

true인 경우 버튼이 비활성 상태로 표시되고 사용자 작업에 응답하지 않습니다.
altText

string

접근성에 사용되는 대체 텍스트입니다.

사용자에게 버튼의 기능을 알려주는 설명 텍스트를 설정합니다. 예를 들어 버튼이 하이퍼링크를 여는 경우 '새 브라우저 탭을 열고 https://developers.google.com/workspace/chat"에서 Google Chat 개발자 문서로 이동합니다'라고 작성할 수 있습니다.
type

enum (Type)

선택사항입니다. 버튼 유형입니다. 설정하지 않으면 버튼 유형은 기본적으로 OUTLINED입니다. color 필드가 설정된 경우 버튼 유형은 FILLED로 강제 설정되며 이 필드에 설정된 값은 무시됩니다.

유형

선택사항입니다. 버튼의 유형입니다. color 필드가 설정된 경우 type는 FILLED로 강제 설정됩니다.

Google Chat 앱에서 사용할 수 있으며 Google Workspace 부가기능에서는 사용할 수 없습니다.

열거형
TYPE_UNSPECIFIED 사용하지 마세요. 지정되지 않음.
OUTLINED 윤곽선 버튼은 중간 강조 버튼입니다. 일반적으로 중요하지만 Chat 앱 또는 부가기능의 기본 작업이 아닌 작업이 포함됩니다.
FILLED 채워진 버튼에는 단색 컨테이너가 있습니다. 시각적 효과가 가장 크며 Chat 앱 또는 부가기능에서 중요하고 기본적인 작업에 권장됩니다.
FILLED_TONAL 채워진 색조 버튼은 채워진 버튼과 윤곽선 버튼 사이의 중간 지점에 해당합니다. 우선순위가 낮은 버튼을 윤곽선 버튼보다 약간 더 강조해야 하는 상황에서 유용합니다.
BORDERLESS 버튼은 기본 상태에서 보이지 않는 컨테이너를 갖지 않습니다. 우선순위가 가장 낮은 작업에 주로 사용되며, 특히 여러 옵션을 표시할 때 사용됩니다.