카드
카드는 텍스트 및 이미지와 같은 UI 위젯을 포함할 수 있는 UI 요소입니다.
JSON 표현 |
---|
{ "header": { object ( |
필드 | |
---|---|
header
|
카드의 헤더입니다. 헤더에는 일반적으로 제목과 이미지가 포함됩니다. |
sections[]
|
섹션은 선 구분자로 구분됩니다. |
card
|
이 카드의 작업입니다. |
name
|
카드 이름입니다. |
CardHeader
JSON 표현 |
---|
{
"title": string,
"subtitle": string,
"imageStyle": enum ( |
필드 | |
---|---|
title
|
제목을 지정해야 합니다. 헤더의 높이가 고정되어 있습니다. 제목과 부제목이 모두 지정된 경우에는 각각 한 줄을 차지합니다. 제목만 지정하면 두 줄을 모두 차지합니다. |
subtitle
|
카드 헤더의 부제입니다. |
image
|
이미지 유형입니다 (예: 정사각형 테두리 또는 원형 테두리). |
image
|
카드 헤더의 이미지 URL입니다. |
ImageStyle
열거형 | |
---|---|
IMAGE_STYLE_UNSPECIFIED
|
|
IMAGE
|
사각형 테두리 |
AVATAR
|
원형 테두리 |
섹션
섹션에는 지정된 순서대로(세로로) 렌더링되는 위젯 모음이 포함됩니다. 모든 플랫폼에서 카드의 너비는 고정되어 있으므로 현재 레이아웃 속성(예: 플로팅)이 필요하지 않습니다.
JSON 표현 |
---|
{
"header": string,
"widgets": [
{
object ( |
필드 | |
---|---|
header
|
섹션의 헤더입니다. 서식이 지정된 텍스트는 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요. |
widgets[]
|
섹션에는 위젯이 하나 이상 포함되어야 합니다. |
WidgetMarkup
위젯은 텍스트와 이미지를 표시하는 UI 요소입니다.
JSON 표현 |
---|
{ "buttons": [ { object ( |
필드 | |
---|---|
buttons[]
|
버튼 목록입니다. Buttons도 |
공용체 필드 data 입니다. WidgetMarkup 에는 다음 항목 중 하나만 있을 수 있습니다. 여러 WidgetMarkup 필드를 사용하여 더 많은 항목을 표시할 수 있습니다.
data 는 다음 중 하나여야 합니다.
|
|
text
|
이 위젯에 텍스트 단락을 표시합니다. |
image
|
이 위젯에 이미지를 표시합니다. |
key
|
이 위젯에 키-값 항목을 표시합니다. |
TextParagraph
텍스트의 단락입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요.
JSON 표현 |
---|
{ "text": string } |
필드 | |
---|---|
text
|
|
이미지
URL로 지정되고 onclick
작업을 포함할 수 있는 이미지입니다.
JSON 표현 |
---|
{
"imageUrl": string,
"onClick": {
object ( |
필드 | |
---|---|
image
|
이미지의 URL입니다. |
on
|
|
aspect
|
이 이미지의 가로세로 비율(너비 및 높이)입니다. 이 입력란을 사용하면 이미지가 로드되는 동안 이미지의 높이를 적절하게 예약할 수 있습니다. 이미지의 내장 가로세로 비율을 재정의하기 위한 것이 아닙니다. 설정하지 않으면 서버에서 이미지를 미리 가져와 이미지를 채웁니다. |
OnClick
onclick
작업 (예: 링크 열기)
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드
|
|
action
|
이 |
open
|
지정된 경우 이 |
FormAction
양식 작업은 양식이 제출될 때의 동작을 설명합니다. 예를 들어 Apps Script를 호출하여 양식을 처리할 수 있습니다.
JSON 표현 |
---|
{
"actionMethodName": string,
"parameters": [
{
object ( |
필드 | |
---|---|
action
|
메서드 이름은 양식의 어느 부분이 양식 제출을 트리거했는지 식별하는 데 사용됩니다. 이 정보는 카드 클릭 이벤트의 일부로 채팅 앱에 다시 에코됩니다. 공통 동작을 트리거하는 여러 요소에 동일한 메서드 이름을 사용할 수 있습니다. |
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 ( |
필드 | |
---|---|
top
|
최상위 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요. |
content
|
콘텐츠의 텍스트입니다. 서식 있는 텍스트가 지원되며 항상 필수사항입니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱에서 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요. |
content
|
콘텐츠가 여러 줄이어야 하는 경우 |
bottom
|
하단 라벨의 텍스트입니다. 서식이 지정된 텍스트가 지원됩니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱에서 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요. |
on
|
|
통합 필드 icons 입니다. 아이콘 top_label 및 bottom_label 중 하나 이상을 정의해야 합니다.
icons 는 다음 중 하나여야 합니다.
|
|
icon
|
Chat API에서 해당 아이콘 이미지로 대체하는 enum 값입니다. |
icon
|
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 |
필드 | |
---|---|
공용체 필드
|
|
text
|
텍스트와 |
image
|
이미지와 |
TextButton
텍스트와 onclick
작업이 있는 버튼
JSON 표현 |
---|
{
"text": string,
"onClick": {
object ( |
필드 | |
---|---|
text
|
버튼의 텍스트입니다. |
on
|
버튼의 |
ImageButton
onclick
작업이 있는 이미지 버튼
JSON 표현 |
---|
{ "onClick": { object ( |
필드 | |
---|---|
on
|
|
name
|
접근성에 사용되는 이 |
통합 필드 icons 입니다. 아이콘은 Icon , enum 또는 URL로 지정할 수 있습니다.
icons 는 다음 중 하나여야 합니다.
|
|
icon
|
Chat API에서 제공하는 아이콘의 색인을 생성하는 |
icon
|
URL로 지정된 아이콘입니다. |
CardAction
카드 작업은 카드와 연결된 작업입니다. 인보이스 카드의 일반적인 작업은 인보이스를 삭제하거나, 인보이스를 이메일로 보내거나, 브라우저에서 인보이스를 여는 것입니다.
Google Chat 앱에서는 지원되지 않습니다.
JSON 표현 |
---|
{
"actionLabel": string,
"onClick": {
object ( |
필드 | |
---|---|
action
|
작업 메뉴 항목에 표시되던 라벨입니다. |
on
|
이 작업 항목의 온클릭 작업입니다. |