카드
카드는 텍스트와 이미지와 같은 UI 위젯을 포함할 수 있는 UI 요소입니다.
JSON 표현 |
---|
{ "header": { object ( |
입력란 | |
---|---|
header
|
카드의 헤더입니다. 헤더에는 일반적으로 제목과 이미지를 포함합니다. |
sections[]
|
섹션은 줄 구분선으로 구분됩니다. |
cardActions[]
|
이 카드의 작업입니다. |
name
|
카드 이름입니다. |
CardHeader
JSON 표현 |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum (
|
입력란 | |
---|---|
title
|
제목을 지정해야 합니다. 헤더의 높이는 고정되어 있습니다. 제목과 부제목이 모두 지정된 경우 각각 한 줄을 차지합니다. 제목만 지정된 경우 두 줄을 모두 사용합니다. |
subtitle
|
카드 헤더의 부제목입니다. |
imageStyle
|
이미지의 유형입니다 (예: 사각형 테두리 또는 원형 테두리). |
imageUrl
|
카드 헤더에 있는 이미지의 URL입니다. |
ImageStyle
열거형 | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
정사각형 테두리 |
AVATAR
|
원형 테두리 |
섹션
섹션에는 지정된 순서대로 (세로로) 렌더링되는 위젯 모음이 포함됩니다. 모든 플랫폼에서 카드의 고정 너비가 좁으므로 현재 레이아웃 속성 (예: 플로팅)이 필요하지 않습니다.
JSON 표현 |
---|
{
"header": string,
"widgets": [
{
object (
|
입력란 | |
---|---|
header
|
섹션의 헤더입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요. |
widgets[]
|
섹션에는 위젯이 하나 이상 포함되어야 합니다. |
WidgetMarkup
위젯은 텍스트와 이미지를 표시하는 UI 요소입니다.
JSON 표현 |
---|
{ "buttons": [ { object ( |
입력란 | |
---|---|
buttons[]
|
버튼 목록입니다. 버튼도 |
통합 필드 data . WidgetMarkup 에는 다음 항목 중 하나만 포함할 수 있습니다. 여러 WidgetMarkup 필드를 사용하여 더 많은 항목을 표시할 수 있습니다.
data 는 다음 중 하나여야 합니다.
|
|
textParagraph
|
이 위젯에 텍스트 단락을 표시합니다. |
image
|
이 위젯에 이미지를 표시합니다. |
keyValue
|
이 위젯에 키-값 항목을 표시합니다. |
TextParagraph
텍스트 단락입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요.
JSON 표현 |
---|
{ "text": string } |
입력란 | |
---|---|
text
|
|
이미지
URL로 지정되고 onclick
작업을 포함할 수 있는 이미지입니다.
JSON 표현 |
---|
{
"imageUrl": string,
"onClick": {
object (
|
입력란 | |
---|---|
imageUrl
|
이미지의 URL입니다. |
onClick
|
|
aspectRatio
|
이미지의 가로 세로 비율 (너비 및 높이)입니다. 이 필드를 사용하면 이미지가 로드되기를 기다리는 동안 이미지의 올바른 높이를 예약할 수 있습니다. 이미지의 기본 가로세로 비율을 재정의하는 것은 아닙니다. 설정하지 않으면 서버에서 이미지를 미리 가져와 이미지를 채웁니다. |
OnClick
onclick
작업 (예: 링크 열기)
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드
|
|
action
|
이 |
openLink
|
이 |
FormAction
양식 작업은 양식이 제출될 때의 동작을 설명합니다. 예를 들어 Apps Script를 호출하여 양식을 처리할 수 있습니다.
JSON 표현 |
---|
{
"actionMethodName": string,
"parameters": [
{
object (
|
입력란 | |
---|---|
actionMethodName
|
메서드 이름은 양식에서 양식 제출을 트리거한 부분을 식별하는 데 사용됩니다. 이 정보는 카드 클릭 이벤트의 일부로 채팅 앱에 다시 에코됩니다. 공통 동작을 트리거하는 여러 요소에 동일한 메서드 이름을 사용할 수 있습니다. |
parameters[]
|
작업 매개변수 목록입니다. |
ActionParameter
작업 메서드가 호출될 때 제공할 문자열 매개변수의 목록입니다. 예를 들어 다시 알림 버튼 3개(지금 다시 알림, 하루 다시 알림, 다음 주에 다시 알림)가 있다고 가정해 보겠습니다. 문자열 매개변수 목록에 다시 알림 유형과 다시 알림 시간을 전달하는 action method = snooze()
를 사용할 수 있습니다.
JSON 표현 |
---|
{ "key": string, "value": string } |
입력란 | |
---|---|
key
|
액션 스크립트의 매개변수 이름입니다. |
value
|
매개변수 값입니다. |
OpenLink
새 창을 여는 링크.
JSON 표현 |
---|
{ "url": string } |
입력란 | |
---|---|
url
|
열 URL입니다. |
KeyValue
UI 요소에는 키 (라벨)와 값 (콘텐츠)이 포함됩니다. 이 요소에는 onclick
버튼과 같은 일부 작업도 포함될 수 있습니다.
JSON 표현 |
---|
{ "topLabel": string, "content": string, "contentMultiline": boolean, "bottomLabel": string, "onClick": { object ( |
입력란 | |
---|---|
topLabel
|
상단 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요. |
content
|
콘텐츠의 텍스트입니다. 서식이 지정된 텍스트가 지원되며 항상 필요합니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요. |
contentMultiline
|
콘텐츠를 여러 줄로 작성해야 하는지 여부입니다. |
bottomLabel
|
하단 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정을 참고하세요. |
onClick
|
|
통합 필드 icons . 아이콘, top_label , bottom_label 중 하나 이상을 정의해야 합니다.
icons 는 다음 중 하나여야 합니다.
|
|
icon
|
Chat API로 해당 아이콘 이미지로 대체되는 열거형 값입니다. |
iconUrl
|
URL로 지정된 아이콘입니다. |
통합 필드 control . 컨트롤 위젯 button 또는 switch_widget 중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다.
control 는 다음 중 하나여야 합니다.
|
|
button
|
클릭하여 작업을 트리거할 수 있는 버튼입니다. |
icon
지원되는 아이콘 집합입니다.
열거형 | |
---|---|
ICON_UNSPECIFIED
|
|
AIRPLANE
|
|
BOOKMARK
|
|
BUS
|
|
CAR
|
|
CLOCK
|
|
CONFIRMATION_NUMBER_ICON
|
|
DOLLAR
|
|
DESCRIPTION
|
|
EMAIL
|
|
EVENT_PERFORMER
|
|
EVENT_SEAT
|
|
FLIGHT_ARRIVAL
|
|
FLIGHT_DEPARTURE
|
|
HOTEL
|
|
HOTEL_ROOM_TYPE
|
|
INVITE
|
|
MAP_PIN
|
|
MEMBERSHIP
|
|
MULTIPLE_PEOPLE
|
|
OFFER
|
|
PERSON
|
|
PHONE
|
|
RESTAURANT_ICON
|
|
SHOPPING_CART
|
|
STAR
|
|
STORE
|
|
TICKET
|
|
TRAIN
|
|
VIDEO_CAMERA
|
|
VIDEO_PLAY
|
버튼
버튼 텍스트 버튼 또는 이미지 버튼일 수 있습니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드
|
|
textButton
|
텍스트와 |
imageButton
|
이미지와 |
TextButton
텍스트와 onclick
작업이 있는 버튼
JSON 표현 |
---|
{
"text": string,
"onClick": {
object (
|
입력란 | |
---|---|
text
|
버튼의 텍스트입니다. |
onClick
|
버튼의 |
ImageButton
onclick
작업이 있는 이미지 버튼
JSON 표현 |
---|
{ "onClick": { object ( |
입력란 | |
---|---|
onClick
|
|
name
|
접근성에 사용되는 이 |
통합 필드 icons . 아이콘은 Icon
enum 또는 URL로 지정할 수 있습니다.
icons 는 다음 중 하나여야 합니다.
|
|
icon
|
Chat API에서 제공하는 아이콘을 나타내는 |
iconUrl
|
URL로 지정된 아이콘입니다. |
CardAction
카드 작업은 카드와 관련된 작업입니다. 인보이스 카드의 경우 일반적인 작업은 인보이스 삭제, 이메일 인보이스 삭제 또는 브라우저에서 인보이스 열기입니다.
Google Chat 앱에서는 지원되지 않습니다.
JSON 표현 |
---|
{
"actionLabel": string,
"onClick": {
object (
|
입력란 | |
---|---|
actionLabel
|
이전에는 작업 메뉴 항목에 표시되었습니다. |
onClick
|
이 작업 항목의 온클릭 작업입니다. |