Package google.apps.card.v1

string

포함하는 요소를 클릭하거나 다른 방식으로 활성화할 때 호출할 맞춤 함수입니다.

사용 예는 양식 데이터 읽기를 참고하세요.

ActionParameter

작업 매개변수 목록입니다.

LoadIndicator

작업을 호출하는 동안 표시되는 로드 표시기를 지정합니다.

bool

작업 후에도 양식 값이 유지되는지 여부를 나타냅니다. 기본값은 false입니다.

true인 경우 작업이 트리거된 후에도 양식 값이 유지됩니다. 작업이 처리되는 동안 사용자가 변경할 수 있도록 하려면 LoadIndicator를 NONE로 설정합니다. Chat 앱의 카드 메시지도 작업의 ResponseType을 UPDATE_MESSAGE로 설정하고 작업이 포함된 카드에서 동일한 card_id을 사용해야 합니다.

false인 경우 작업이 트리거될 때 양식 값이 지워집니다. 작업이 처리되는 동안 사용자가 변경하지 못하게 하려면 LoadIndicator를 SPINNER로 설정합니다.

Interaction

선택사항입니다. 대화상자를 열 때 필요합니다.

사용자와의 상호작용(예: 사용자가 카드 메시지의 버튼을 클릭하는 경우)에 대한 응답으로 수행할 작업입니다.

지정하지 않으면 앱은 정상적으로 action를 실행하여 응답합니다(예: 링크 열기 또는 함수 실행).

interaction를 지정하면 앱이 특별한 대화형 방식으로 응답할 수 있습니다. 예를 들어 interaction를 OPEN_DIALOG로 설정하면 앱에서 대화상자를 열 수 있습니다. 지정하면 로드 표시기가 표시되지 않습니다. 부가기능에 지정된 경우 전체 카드가 제거되고 클라이언트에 아무 것도 표시되지 않습니다.

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

string

이 작업이 호출될 때 여기에 나열된 위젯에 값이 없으면 양식 제출이 취소됩니다.

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

bool

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

string

작업 스크립트의 매개변수 이름입니다.

string

매개변수의 값입니다.

BorderType

테두리 유형입니다.

Color

유형이 BORDER_TYPE_STROKE일 때 사용할 색상입니다.

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

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

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

alpha 입력란은 획 색상에는 사용할 수 없습니다. 지정하면 이 필드는 무시됩니다.

int32

테두리의 모서리 반경입니다.

string

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

Icon

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

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

필수 항목입니다. 사용자가 버튼을 클릭할 때 하이퍼링크를 열거나 맞춤 함수를 실행하는 등 실행할 작업입니다.

bool

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

string

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

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

Type

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

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

Button

버튼의 배열입니다.

CardHeader

카드의 헤더입니다. 헤더에는 일반적으로 선행 이미지와 제목이 포함됩니다. 헤더는 항상 카드 상단에 표시됩니다.

Section

위젯 컬렉션을 포함합니다. 각 섹션에는 자체적인 선택적 헤더가 있습니다. 섹션은 선 구분선으로 시각적으로 구분됩니다. Google Chat 앱의 예는 카드 섹션 정의를 참고하세요.

DividerStyle

섹션 사이의 구분선 스타일입니다.

CardAction

카드 작업 작업의 툴바 메뉴에 카드가 추가됩니다.

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

예를 들어 다음 JSON은 Settings 및 Send Feedback 옵션으로 카드 작업 메뉴를 구성합니다.

"cardActions": [
  {
    "actionLabel": "Settings",
    "onClick": {
      "action": {
        "functionName": "goToView",
        "parameters": [
          {
            "key": "viewType",
            "value": "SETTING"
         }
        ],
        "loadIndicator": "LoadIndicator.SPINNER"
      }
    }
  },
  {
    "actionLabel": "Send Feedback",
    "onClick": {
      "openLink": {
        "url": "https://example.com/feedback"
      }
    }
  }
]

string

카드 이름입니다. 카드 탐색에서 카드 식별자로 사용됩니다.

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

CardFixedFooter

이 카드 하단에 표시된 고정 바닥글입니다.

primaryButton 또는 secondaryButton를 지정하지 않고 fixedFooter를 설정하면 오류가 발생합니다. 채팅 앱의 경우 대화상자에서 고정 바닥글을 사용할 수 있지만 카드 메시지는 사용할 수 없습니다.

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

DisplayStyle

Google Workspace 부가기능에서 peekCardHeader의 표시 속성을 설정합니다.

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

CardHeader

문맥 콘텐츠를 표시할 때 미리보기 카드 헤더는 사용자가 홈페이지 카드와 문맥 카드 사이를 앞으로 이동할 수 있도록 자리표시자 역할을 합니다.

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

string

작업 메뉴 항목으로 표시되는 라벨입니다.

OnClick

이 작업 항목의 onClick 작업

Button

고정 바닥글의 기본 버튼입니다. 버튼은 텍스트와 색상이 설정된 텍스트 버튼이어야 합니다.

Button

고정 바닥글의 보조 버튼입니다. 버튼은 텍스트와 색상이 설정된 텍스트 버튼이어야 합니다. secondaryButton가 설정되면 primaryButton도 설정해야 합니다.

string

필수 항목입니다. 카드 헤더의 제목입니다. 헤더의 높이가 고정되어 있습니다. 제목과 부제목이 모두 지정된 경우에는 각각 한 줄을 차지합니다. 제목만 지정된 경우 두 줄을 모두 차지합니다.

string

카드 헤더의 부제목입니다. 지정하면 title 아래 한 줄에 하나씩 표시됩니다.

ImageType

이미지를 자르는 데 사용되는 도형입니다.

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

string

카드 헤더에 있는 이미지의 HTTPS URL입니다.

string

접근성을 위해 사용되는 이 이미지의 대체 텍스트입니다.

string

섹션 상단에 표시되는 텍스트입니다. 간단한 HTML 형식의 텍스트를 지원합니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요.

Widget

섹션의 모든 위젯입니다. 위젯을 하나 이상 포함해야 합니다.

bool

이 섹션을 접을 수 있는지 여부를 나타냅니다.

접을 수 있는 섹션에서는 일부 또는 모든 위젯이 숨겨지지만 사용자는 더보기를 클릭하여 섹션을 펼쳐 숨겨진 위젯을 표시할 수 있습니다. 사용자는 간략히 보기를 클릭하여 위젯을 다시 숨길 수 있습니다.

숨겨지는 위젯을 결정하려면 uncollapsibleWidgetsCount를 지정합니다.

int32

섹션이 접혀 있어도 접을 수 없는 위젯이 계속 표시되는 위젯의 수입니다.

예를 들어 섹션에 5개의 위젯이 포함되어 있고 uncollapsibleWidgetsCount이 2로 설정된 경우 처음 두 위젯은 항상 표시되고 마지막 3개 위젯은 기본적으로 접혀 있습니다. uncollapsibleWidgetsCount는 collapsible가 true인 경우에만 고려됩니다.

CollapseControl

선택사항입니다. 섹션의 펼치기 및 접기 버튼을 정의합니다. 이 버튼은 섹션을 접을 수 있는 경우에만 표시됩니다. 이 필드를 설정하지 않으면 기본 버튼이 사용됩니다. Google Chat 앱에서는 사용할 수 있지만 Google Workspace 부가기능에서는 사용할 수 없습니다.

Icon

아이콘 이미지입니다. icon와 text가 모두 설정되면 텍스트 앞에 아이콘이 표시됩니다.

string

칩 내부에 표시되는 텍스트입니다.

OnClick

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

bool

칩이 활성 상태이고 사용자 작업에 응답하는지 여부입니다. 기본값은 true입니다. 지원 중단되었습니다. 대신 disabled를 사용합니다.

bool

칩이 비활성 상태이고 사용자 작업을 무시하는지 여부입니다. 기본값은 false입니다.

string

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

사용자가 칩의 기능을 알 수 있도록 설명 텍스트를 설정합니다. 예를 들어 칩이 하이퍼링크를 여는 경우 '새 브라우저 탭을 열고 https://developers.google.com/workspace/chat"의 Google Chat 개발자 문서로 이동합니다.

Layout

지정된 칩 목록 레이아웃

Chip

칩의 배열입니다.

HorizontalAlignment

펼치기 및 접기 버튼의 가로 정렬입니다.

Button

선택사항입니다. 맞춤설정 가능한 버튼을 정의하여 섹션을 펼칩니다. 펼치기 버튼 및 접기버튼 필드를 모두 설정해야 합니다. 하나의 필드 세트만 적용되지 않습니다. 이 필드를 설정하지 않으면 기본 버튼이 사용됩니다.

Button

선택사항입니다. 섹션을 접을 수 있는 맞춤설정 가능한 버튼을 정의합니다. 펼치기 버튼 및 접기버튼 필드를 모두 설정해야 합니다. 하나의 필드 세트만 적용되지 않습니다. 이 필드를 설정하지 않으면 기본 버튼이 사용됩니다.

Column

열의 배열입니다. 카드 또는 대화상자에 최대 2개의 열을 포함할 수 있습니다.

HorizontalSizeStyle

열이 카드 너비를 채우는 방식을 지정합니다.

HorizontalAlignment

위젯을 열의 왼쪽, 오른쪽 또는 가운데에 정렬할지 지정합니다.

VerticalAlignment

위젯을 열의 상단, 하단, 가운데에 정렬할지 지정합니다.

Widgets

열에 포함된 위젯의 배열입니다. 위젯은 지정된 순서대로 표시됩니다.

TextParagraph

TextParagraph 위젯

Image

Image 위젯

DecoratedText

DecoratedText 위젯

ButtonList

ButtonList 위젯

TextInput

TextInput 위젯

SelectionInput

SelectionInput 위젯

DateTimePicker

DateTimePicker 위젯

ChipList

ChipList 위젯 Google Chat 앱에서는 사용할 수 있지만 Google Workspace 부가기능에서는 사용할 수 없습니다.

string

양식 입력 이벤트에서 DateTimePicker를 식별하는 이름입니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

string

사용자에게 날짜, 시간 또는 날짜와 시간을 입력하라는 메시지를 표시하는 텍스트입니다. 예를 들어 사용자가 약속을 예약하는 경우 Appointment date 또는 Appointment date and time과 같은 라벨을 사용합니다.

DateTimePickerType

위젯에서 날짜, 시간 또는 날짜와 시간 입력을 지원하는지 여부입니다.

int64

위젯에 표시되는 기본값(Unix 에포크 시간 이후 밀리초 단위)입니다.

선택도구 유형 (DateTimePickerType)에 따라 값을 지정합니다.

• DATE_AND_TIME: UTC 형식의 캘린더 날짜 및 시간입니다. 예를 들어 2023년 1월 1일 오후 12시(UTC)를 나타내려면 1672574400000을 사용합니다.
• DATE_ONLY: 캘린더 날짜 00:00:00 UTC입니다. 예를 들어 2023년 1월 1일을 나타내려면 1672531200000을 사용합니다.
• TIME_ONLY: UTC 시간입니다. 예를 들어 오후 12시를 나타내려면 43200000 (또는 12 * 60 * 60 * 1000)를 사용합니다.

int32

UTC로부터의 시간대 오프셋을 분 단위로 나타내는 숫자입니다. 설정하면 value_ms_epoch이 지정된 시간대에 표시됩니다. 설정하지 않으면 기본값은 사용자의 시간대 설정으로 설정됩니다.

Action

사용자가 DateTimePicker 인터페이스에서 저장 또는 지우기를 클릭할 때 트리거됩니다.

Validation

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

Icon

지원 중단되고 startIcon로 대체되었습니다.

Icon

텍스트 앞에 표시되는 아이콘입니다.

string

text 위에 표시되는 텍스트입니다. 항상 자릅니다.

string

필수 항목입니다. 기본 텍스트입니다.

간단한 형식을 지원합니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요.

bool

텍스트 줄바꿈 설정입니다. true인 경우 텍스트가 줄바꿈되어 여러 줄에 표시됩니다. 그렇지 않으면 텍스트가 잘립니다.

text에만 적용되며 topLabel 및 bottomLabel에는 적용되지 않습니다.

string

text 아래에 표시되는 텍스트입니다. 항상 래핑

OnClick

이 작업은 사용자가 topLabel 또는 bottomLabel 버튼을 클릭할 때 트리거됩니다.

Button

사용자가 클릭하여 작업을 트리거할 수 있는 버튼입니다.

SwitchControl

사용자가 클릭하여 상태를 변경하고 작업을 트리거할 수 있는 스위치 위젯입니다.

Icon

텍스트 뒤에 표시되는 아이콘입니다.

내장 및 맞춤 아이콘을 지원합니다.

string

양식 입력 이벤트에서 스위치 위젯이 식별되는 이름입니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

string

사용자가 입력한 값으로, 양식 입력 이벤트의 일부로 반환됩니다.

양식 입력란 작업에 관한 자세한 내용은 양식 데이터 수신을 참고하세요.

bool

true인 경우 스위치가 선택됩니다.

Action

전환 상태가 변경될 때 실행할 작업입니다(예: 실행할 함수).

ControlType

사용자 인터페이스에 스위치가 표시되는 방식입니다.

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

Action

클라이언트가 대화상자 흐름을 종료하는 렌더링 작업입니다.

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

Suggestions

string

이는 구문 검사를 위한 마크업에 있을 수 있는 노옵스(no-ops) 스키마 필드입니다.

string

그리드 헤더에 표시되는 텍스트입니다.

GridItem

그리드에 표시할 항목입니다.

BorderStyle

각 그리드 항목에 적용할 테두리 스타일입니다.

int32

그리드에 표시할 열의 수입니다. 이 필드가 지정되지 않은 경우 기본값이 사용되며 그 기본값은 그리드가 표시되는 위치 (대화상자 또는 컴패니언)에 따라 다릅니다.

OnClick

이 콜백은 각 개별 그리드 항목에서 재사용되지만 항목 목록의 항목 식별자와 색인이 콜백의 매개변수에 추가됩니다.

string

이 그리드 항목의 사용자 지정 식별자입니다. 이 식별자는 상위 그리드의 onClick 콜백 매개변수에 반환됩니다.

ImageComponent

그리드 항목에 표시되는 이미지입니다.

string

그리드 항목의 제목입니다.

string

그리드 항목의 부제목입니다.

GridItemLayout

그리드 항목에 사용할 레이아웃입니다.

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

이미지에 적용된 자르기 스타일입니다. CIRCLE 자르기를 적용하면 이미지가 기본 제공 아이콘보다 크게 그려지는 경우가 있습니다.

string

Google Workspace에서 제공하는 기본 제공 아이콘 중 하나를 표시합니다.

예를 들어 비행기 아이콘을 표시하려면 AIRPLANE를 지정합니다. 버스의 경우 BUS를 지정합니다.

지원되는 아이콘의 전체 목록은 내장 아이콘을 참고하세요.

string

HTTPS URL에서 호스팅되는 맞춤 아이콘을 표시합니다.

예를 들면 다음과 같습니다.

"iconUrl":
"https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png"

지원되는 파일 형식에는 .png 및 .jpg이 포함됩니다.

MaterialIcon

Google 머티리얼 아이콘 중 하나를 표시합니다.

예를 들어 체크박스 아이콘을 표시하려면

"materialIcon": {
  "name": "check_box"
}

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

string

이미지를 호스팅하는 HTTPS URL입니다.

예를 들면 다음과 같습니다.

https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png

OnClick

사용자가 이미지를 클릭하면 클릭 시 이 액션이 트리거됩니다.

string

접근성을 위해 사용되는 이 이미지의 대체 텍스트입니다.

string

이미지 URL입니다.

string

이미지의 접근성 라벨입니다.

ImageCropStyle

이미지에 적용할 자르기 스타일입니다.

BorderStyle

이미지에 적용할 테두리 스타일입니다.

ImageCropType

자르기 유형

double

자르기 유형이 RECTANGLE_CUSTOM인 경우 사용할 가로세로 비율입니다.

예를 들어 16:9 가로세로 비율을 적용하는 방법은 다음과 같습니다.

cropStyle {
 "type": "RECTANGLE_CUSTOM",
 "aspectRatio": 16/9
}

string

부가기능으로 돌아갈 링크의 URL입니다.

string

부가기능으로 돌아갈 링크의 제목입니다.

Card

서드 파티 서비스의 링크에 관한 정보를 표시하는 카드입니다.

string

링크 미리보기의 스마트 칩에 표시되는 제목입니다. 설정하지 않으면 스마트 칩에 preview_card의 헤더가 표시됩니다.

string

링크 미리보기에 표시되는 제목입니다. 설정하지 않으면 링크 미리보기에 preview_card의 헤더가 표시됩니다.

string

Google 머티리얼 아이콘에 정의된 아이콘 이름(예: check_box) 잘못된 이름은 폐기되고 빈 문자열로 대체되어 아이콘이 렌더링되지 않습니다.

bool

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

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

int32

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

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

int32

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

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

bool

카드 스택은 루트 카드를 제외한 모든 카드를 팝합니다.

bool

카드 스택에서 카드가 한 장씩 빠집니다.

string

카드 스택은 특정 카드 이름을 가진 지정된 카드 위에 모든 카드를 팝합니다.

Card

카드 스택은 카드를 카드 스택으로 푸시합니다.

Card

카드 스택은 상단 카드를 새 카드로 업데이트하고 채워진 양식 필드 값을 유지합니다. 같지 않은 필드의 경우 값이 삭제됩니다.

EndNavigation

대화상자 흐름에서 탐색 작업이 종료됩니다. 자세한 내용은 Google Chat 앱의 홈페이지 빌드하기를 참고하세요.

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

string

알림에 대해 HTML 태그 없이 표시할 일반 텍스트입니다.

Action

지정하면 이 onClick에 의해 작업이 트리거됩니다.

OpenLink

지정된 경우 이 onClick가 링크 열기 작업을 트리거합니다.

Action

작업에서 링크를 열어야 하는 경우 부가기능에서 이 작업을 트리거합니다. 이는 링크를 가져오기 위해 서버와 통신해야 한다는 점에서 위의 open_link와 다릅니다. 따라서 열린 링크 작업 응답이 돌아오기 전에 웹 클라이언트가 준비 작업을 수행해야 합니다.

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

Card

지정된 경우 클릭하면 새 카드가 카드 스택으로 푸시됩니다.

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

OverflowMenu

지정하면 이 onClick에서 더보기 메뉴가 열립니다. Google Chat 앱에서는 사용할 수 있지만 Google Workspace 부가기능에서는 사용할 수 없습니다.

string

열려는 URL입니다.

OpenAs

링크를 여는 방법

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

OnClose

클라이언트가 링크를 연 후에 잊어버리거나 창이 닫힐 때까지 링크를 관찰하는지 여부입니다.

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

OverflowMenuItem

필수 항목입니다. 메뉴 옵션 목록입니다.

Icon

텍스트 앞에 표시되는 아이콘입니다.

string

필수 항목입니다. 상품을 식별하거나 사용자에게 설명하는 텍스트입니다.

OnClick

필수 항목입니다. 메뉴 옵션이 선택되면 호출되는 작업입니다. 이 OnClick에는 OverflowMenu를 포함할 수 없습니다. 지정된 OverflowMenu가 삭제되고 메뉴 항목이 사용 중지됩니다.

bool

메뉴 옵션의 사용 중지 여부입니다. 기본값은 false입니다.

Action

HostAppActionMarkup

개별 호스트 앱에서 처리하는 작업

string

이는 구문 검사를 위한 마크업에 있을 수 있는 노옵스(no-ops) 스키마 필드입니다.

Navigation

표시된 카드를 푸시하거나, 팝하거나, 업데이트합니다.

OpenLink

새 탭 또는 팝업에서 대상 링크를 즉시 엽니다.

Notification

최종 사용자에게 알림을 표시합니다.

LinkPreview

최종 사용자에게 링크 미리보기를 표시합니다.

Link

Google Workspace 애플리케이션 내에서 생성된 서드 파티 리소스의 링크입니다. 항목이 한 개 있는 객체의 배열 형식으로 지정됩니다. 자세한 내용은 @ 메뉴에서 서드 파티 리소스 만들기를 참고하세요.

string

필수 항목입니다. 양식 입력 이벤트에서 선택 입력을 식별하는 이름입니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

string

사용자 인터페이스에서 선택 입력란 위에 표시되는 텍스트입니다.

사용자가 앱에 필요한 정보를 입력하는 데 도움이 되는 텍스트를 지정합니다. 예를 들어 사용자가 드롭다운 메뉴에서 작업 티켓의 긴급도를 선택하는 경우 라벨은 '긴급도' 또는 '긴급도 선택'일 수 있습니다.

SelectionType

SelectionInput 위젯에서 사용자에게 표시되는 항목 유형입니다. 선택 유형은 다양한 유형의 상호작용을 지원합니다. 예를 들어 사용자는 하나 이상의 체크박스를 선택할 수 있지만 드롭다운 메뉴에서 하나의 값만 선택할 수 있습니다.

SelectionItem

선택 가능한 항목의 배열입니다. 라디오 버튼 또는 체크박스의 배열을 예로 들 수 있습니다. 최대 100개 항목을 지원합니다.

Action

지정하면 선택사항이 변경될 때 양식이 제출됩니다. 지정하지 않으면 양식을 제출하는 별도의 버튼을 지정해야 합니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

int32

다중 선택 메뉴의 경우 사용자가 선택할 수 있는 최대 항목 수입니다. 최솟값은 1개 항목입니다. 지정하지 않으면 기본값은 항목 3개입니다.

int32

다중 선택 메뉴의 경우 앱이 쿼리하기 전에 사용자가 입력하는 텍스트 문자 수가 자동 완성되고 메뉴에 추천 항목이 표시됩니다.

지정하지 않을 경우 기본값은 정적 데이터 소스의 경우 0자, 외부 데이터 소스의 경우 3자입니다.

Validation

드롭다운 메뉴의 경우 이 선택 입력란의 유효성 검사입니다.

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

Action

외부 데이터 소스(예: 관계형 데이터베이스)

PlatformDataSource

Google Workspace의 데이터 소스

CommonDataSource

모든 Google Workspace 애플리케이션(예: Google Workspace 조직의 사용자)이 공유하는 데이터 소스입니다.

HostAppDataSourceMarkup

Google Chat의 스페이스와 같은 Google Workspace 호스트 애플리케이션에 고유한 데이터 소스입니다.

이 필드는 Google API 클라이언트 라이브러리를 지원하지만 Cloud 클라이언트 라이브러리에서는 사용할 수 없습니다. 자세한 내용은 클라이언트 라이브러리 설치를 참고하세요.

string

상품을 식별하거나 사용자에게 설명하는 텍스트입니다.

string

이 항목과 연결된 값입니다. 클라이언트는 이 값을 양식 입력 값으로 사용해야 합니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

bool

항목이 기본적으로 선택되는지 여부입니다. 선택 입력에 하나의 값만 허용하는 경우 (예: 라디오 버튼 또는 드롭다운 메뉴) 이 입력란을 하나의 항목에만 설정합니다.

string

다중 선택 메뉴의 경우 아이콘의 URL이 항목의 text 필드 옆에 표시됩니다. PNG 및 JPEG 파일을 지원합니다. HTTPS URL이어야 합니다. https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png를 예로 들 수 있습니다.

string

다중 선택 메뉴의 경우 항목의 text 입력란 아래에 텍스트 설명 또는 라벨이 표시됩니다.

RenderActions

카드에 작업을 실행하도록 지시하거나 부가기능 호스트 앱에 앱별 작업을 실행하도록 지시하는 렌더링 안내 집합입니다.

bool

카드 상태가 변경되었고 기존 카드의 데이터가 비활성 상태인지 여부

string

이는 구문 검사를 위한 마크업에 있을 수 있는 노옵스(no-ops) 스키마 필드입니다.

SuggestionItem

텍스트 입력란에서 자동 완성 추천에 사용되는 추천 목록입니다.

string

텍스트 입력란에 대한 추천 입력 값입니다. 사용자가 직접 입력하는 값과 동일합니다.

string

양식 입력 이벤트에서 텍스트 입력이 식별되는 이름입니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

string

사용자 인터페이스의 텍스트 입력란 위에 표시되는 텍스트입니다.

사용자가 앱에 필요한 정보를 입력하는 데 도움이 되는 텍스트를 지정합니다. 예를 들어 누군가의 이름을 물어보지만 구체적으로 성이 필요한 경우 name 대신 surname라고 입력합니다.

hintText가 지정되지 않은 경우 필수입니다. 그 외의 경우에는 선택사항입니다.

string

사용자에게 특정 값을 입력하라는 메시지를 표시하여 사용자를 지원하기 위한 텍스트 입력란 아래에 표시되는 텍스트입니다. 이 텍스트는 항상 표시됩니다.

label가 지정되지 않은 경우 필수입니다. 그 외의 경우에는 선택사항입니다.

string

사용자가 입력한 값으로, 양식 입력 이벤트의 일부로 반환됩니다.

양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.

Type

사용자 인터페이스에 텍스트 입력란이 표시되는 방식입니다. 예를 들어 필드가 한 줄인지 여러 줄인지를 나타냅니다.

Action

텍스트 입력란이 변경되었을 때 수행할 작업입니다. 예를 들어 사용자가 입력란에 추가하거나 텍스트를 삭제하는 경우가 있습니다.

실행할 작업의 예로는 커스텀 함수를 실행하거나 Google Chat에서 대화상자를 여는 작업이 있습니다.

Suggestions

사용자가 입력할 수 있는 추천 값입니다. 이 값은 사용자가 텍스트 입력란 안을 클릭하면 표시됩니다. 사용자가 입력하면 추천 값이 동적으로 필터링되어 사용자가 입력한 값과 일치합니다.

예를 들어 프로그래밍 언어의 텍스트 입력 필드는 Java, JavaScript, Python, C++를 제안할 수 있습니다. 사용자가 Jav를 입력하기 시작하면 추천 검색어 목록이 Java 및 JavaScript만 표시하도록 필터링합니다.

추천 값은 사용자가 앱에서 이해할 수 있는 값을 입력하도록 안내하는 데 도움이 됩니다. JavaScript를 참조할 때 일부 사용자는 javascript을 입력하고 다른 사용자는 java script을 입력할 수 있습니다. JavaScript를 제안하면 사용자가 앱과 상호작용하는 방식을 표준화할 수 있습니다.

이 플래그를 지정하면 TextInput.type는 MULTIPLE_LINE로 설정되더라도 항상 SINGLE_LINE입니다.

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

Action

선택사항입니다. 텍스트 입력란이 상호작용하는 사용자에게 제안을 제공할 때 수행할 작업을 지정합니다.

지정하지 않으면 initialSuggestions에서 추천을 설정하고 클라이언트에서 처리합니다.

지정하면 앱은 여기에 지정된 작업(예: 맞춤 함수 실행)을 실행합니다.

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

Validation

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

string

필드가 비어 있을 때 텍스트 입력란에 표시되는 텍스트입니다. 이 텍스트를 사용하여 사용자에게 값을 입력하라는 메시지를 표시합니다. 예를 들면 Enter a number from 0 to 100입니다.

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

string

위젯에 표시되는 텍스트입니다.

int32

위젯에 표시되는 최대 텍스트 줄 수입니다. 텍스트가 지정된 최대 줄 수를 초과하면 초과된 콘텐츠가 더보기 버튼 뒤에 숨겨집니다. 텍스트가 지정된 최대 줄 수와 같거나 짧으면 더보기 버튼이 표시되지 않습니다.

기본값은 0이며, 이 경우 모든 컨텍스트가 표시됩니다. 음수 값은 무시됩니다. Google Chat 앱에서는 사용할 수 있지만 Google Workspace 부가기능에서는 사용할 수 없습니다.

int32

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

InputType

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

HorizontalAlignment

위젯을 열의 왼쪽, 오른쪽 또는 가운데에 정렬할지 지정합니다.

TextParagraph

텍스트 단락을 표시합니다. 간단한 HTML 형식의 텍스트를 지원합니다. 텍스트 서식 지정에 관한 자세한 내용은 Google Chat 앱의 텍스트 서식 지정 및 Google Workspace 부가기능에서 텍스트 서식 지정을 참고하세요.

예를 들어 다음 JSON은 굵은 텍스트를 만듭니다.

"textParagraph": {
  "text": "  <b>bold text</b>"
}

Image

이미지를 표시합니다.

예를 들어 다음 JSON은 대체 텍스트가 있는 이미지를 만듭니다.

"image": {
  "imageUrl":
  "https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png",
  "altText": "Chat app avatar"
}

DecoratedText

장식된 텍스트 항목을 표시합니다.

예를 들어 다음 JSON은 이메일 주소를 표시하는 데코레이트된 텍스트 위젯을 만듭니다.

"decoratedText": {
  "icon": {
    "knownIcon": "EMAIL"
  },
  "topLabel": "Email Address",
  "text": "sasha@example.com",
  "bottomLabel": "This is a new Email address!",
  "switchControl": {
    "name": "has_send_welcome_email_to_sasha",
    "selected": false,
    "controlType": "CHECKBOX"
  }
}

ButtonList

버튼 목록입니다.

예를 들어 다음 JSON은 버튼 두 개를 만듭니다. 첫 번째는 파란색 텍스트 버튼이고 두 번째는 링크를 여는 이미지 버튼입니다.

"buttonList": {
  "buttons": [
    {
      "text": "Edit",
      "color": {
        "red": 0,
        "green": 0,
        "blue": 1,
      },
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

TextInput

사용자가 입력할 수 있는 텍스트 상자를 표시합니다.

예를 들어 다음 JSON은 이메일 주소에 대한 텍스트 입력을 만듭니다.

"textInput": {
  "name": "mailing_address",
  "label": "Mailing Address"
}

또 다른 예로, 다음 JSON은 정적 제안을 사용하여 프로그래밍 언어에 대한 텍스트 입력을 만듭니다.

"textInput": {
  "name": "preferred_programing_language",
  "label": "Preferred Language",
  "initialSuggestions": {
    "items": [
      {
        "text": "C++"
      },
      {
        "text": "Java"
      },
      {
        "text": "JavaScript"
      },
      {
        "text": "Python"
      }
    ]
  }
}

SelectionInput

사용자가 항목을 선택할 수 있는 선택 컨트롤을 표시합니다. 선택 컨트롤은 체크박스, 라디오 버튼, 스위치, 드롭다운 메뉴가 될 수 있습니다.

예를 들어 다음 JSON은 사용자가 크기를 선택할 수 있는 드롭다운 메뉴를 만듭니다.

"selectionInput": {
  "name": "size",
  "label": "Size"
  "type": "DROPDOWN",
  "items": [
    {
      "text": "S",
      "value": "small",
      "selected": false
    },
    {
      "text": "M",
      "value": "medium",
      "selected": true
    },
    {
      "text": "L",
      "value": "large",
      "selected": false
    },
    {
      "text": "XL",
      "value": "extra_large",
      "selected": false
    }
  ]
}

DateTimePicker

사용자가 날짜, 시간 또는 날짜 및 시간을 입력할 수 있는 위젯을 표시합니다.

예를 들어 다음 JSON은 약속을 예약하는 날짜 시간 선택 도구를 생성합니다.

"dateTimePicker": {
  "name": "appointment_time",
  "label": "Book your appointment at:",
  "type": "DATE_AND_TIME",
  "valueMsEpoch": "796435200000"
}

Divider

위젯 사이에 가로줄 구분선을 표시합니다.

예를 들어 다음 JSON은 구분선을 만듭니다.

"divider": {
}

Grid

항목 컬렉션이 있는 그리드를 표시합니다.

그리드는 원하는 수의 열과 항목을 지원합니다. 행 수는 항목 수의 상한값을 열 수로 나눈 값으로 결정됩니다. 항목이 10개이고 열이 2개인 그리드에는 5개의 행이 있습니다. 항목이 11개이고 열이 2개인 그리드에는 6개의 행이 있습니다.

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

예를 들어 다음 JSON은 단일 항목이 있는 2열 그리드를 만듭니다.

"grid": {
  "title": "A fine collection of items",
  "columnCount": 2,
  "borderStyle": {
    "type": "STROKE",
    "cornerRadius": 4
  },
  "items": [
    {
      "image": {
        "imageUri": "https://www.example.com/image.png",
        "cropStyle": {
          "type": "SQUARE"
        },
        "borderStyle": {
          "type": "STROKE"
        }
      },
      "title": "An item",
      "textAlignment": "CENTER"
    }
  ],
  "onClick": {
    "openLink": {
      "url": "https://www.example.com"
    }
  }
}

Columns

최대 2개의 열을 표시합니다.

열을 3개 이상 포함하거나 행을 사용하려면 Grid 위젯을 사용합니다.

예를 들어 다음 JSON은 각각 텍스트 단락을 포함하는 2개의 열을 만듭니다.

"columns": {
  "columnItems": [
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "First column text paragraph"
          }
        }
      ]
    },
    {
      "horizontalSizeStyle": "FILL_AVAILABLE_SPACE",
      "horizontalAlignment": "CENTER",
      "verticalAlignment": "CENTER",
      "widgets": [
        {
          "textParagraph": {
            "text": "Second column text paragraph"
          }
        }
      ]
    }
  ]
}

ChipList

칩 목록입니다.

예를 들어 다음 JSON은 2개의 칩을 만듭니다. 첫 번째는 텍스트 칩이고 두 번째는 링크를 여는 아이콘 칩입니다.

"chipList": {
  "chips": [
    {
      "text": "Edit",
      "disabled": true,
    },
    {
      "icon": {
        "knownIcon": "INVITE",
        "altText": "check calendar"
      },
      "onClick": {
        "openLink": {
          "url": "https://example.com/calendar"
        }
      }
    }
  ]
}

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