카드
카드는 텍스트 및 이미지와 같은 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
|
원형 테두리 |
섹션
섹션에는 지정된 순서대로 (세로로) 렌더링되는 위젯 모음이 포함됩니다. 모든 플랫폼에서 카드는 좁은 너비가 고정되어 있으므로 현재는 레이아웃 속성 (예: float)이 필요하지 않습니다.
JSON 표현 |
---|
{
"header": string,
"widgets": [
{
object ( |
필드 | |
---|---|
header
|
섹션의 헤더입니다. 서식이 지정된 텍스트는 지원됩니다. 텍스트 서식 지정에 대한 자세한 내용은 다음을 참고하세요. Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능의 텍스트 서식 지정 |
widgets[]
|
섹션에는 위젯이 하나 이상 있어야 합니다. |
WidgetMarkup
위젯은 텍스트와 이미지를 표시하는 UI 요소입니다.
JSON 표현 |
---|
{ "buttons": [ { object ( |
필드 | |
---|---|
buttons[]
|
버튼 목록입니다. Button도
|
공용체 필드
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
작업 메서드가 호출될 때 제공할 문자열 매개변수의 목록입니다. 예를 들어 '지금 다시 알림', '하루에 다시 알림', '다음 주에 다시 알림' 등 세 가지 일시중지 버튼이 있다고 가정해 보겠습니다. 다음과 같은 방법을 사용할 수 있습니다.
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_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
|
인코더-디코더 아키텍처를
|
iconUrl
|
URL로 지정된 아이콘입니다. |
CardAction
카드 작업은 카드와 연결된 작업입니다. 인보이스 카드의 경우 일반적으로 인보이스 삭제, 이메일 인보이스 발송, 브라우저에서 인보이스 열기 등의 작업이 이루어집니다.
Google Chat 앱에서는 지원되지 않습니다.
JSON 표현 |
---|
{
"actionLabel": string,
"onClick": {
object ( |
필드 | |
---|---|
actionLabel
|
라벨은 작업 메뉴 항목에 표시되곤 했습니다. |
onClick
|
이 작업 항목의 온클릭 작업입니다. |