이 페이지에서는 카드의 기본 UI 구성요소를 디자인하고 만드는 방법을 설명합니다. 채팅 메시지 표시
카드는 정의된 레이아웃을 지원합니다. 대화형 UI 요소(예: 버튼)와 사용할 수 있습니다. 카드를 사용하여 정보를 표시하고, 입력을 수집하고, '서비스'를 통해 사용자에게 다음 단계를 카드 메시지 및 대화상자가 있습니다.
카드 빌더를 사용하여 채팅 앱용 JSON 카드 메시지를 디자인하고 미리 봅니다.
카드 빌더 열기 <ph type="x-smartling-placeholder"></ph>
카드와 대화상자에는 일반적으로 다음과 같은 구성요소가 있습니다.
- 카드 제목이 포함된
CardHeader
. - 카드의 기본을 구성하는 하나 이상의
CardSection
위젯입니다. - 대화상자 전용
CardFixedFooter
위젯
기본 요건
양방향 기능이 사용 설정된 Google Chat 앱 대화식 채팅 앱에서 대화식 채팅 앱을 사용하려면 다음 빠른 시작 중 하나를 완료하세요. 앱 아키텍처에 따라 다음을 수행합니다.
- Google Cloud Functions를 사용하는 HTTP 서비스
- Google Apps Script
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
헤더 추가
CardHeader
위젯
카드의 헤더를 나타냅니다. 헤더에는
제목, 부제목, 아바타 이미지를 입력하세요.
다음을 위해 CardHeader
를 포함할 수 있습니다.
카드 메시지 및
대화상자입니다.
다음은 CardHeader
의 예입니다.
카드의 섹션 정의
CardSection
위젯은
상위 수준 컨테이너에 배치해야 합니다 카드 사용
섹션을 사용하면 카드 내에서 위젯을 그룹화할 수 있습니다. 각 카드 섹션에 다음과 같이
하나 이상의 위젯으로 구성됩니다.
다음을 위해 CardSection
를 포함할 수 있습니다.
카드 메시지 및
대화상자입니다.
다음은 두 개의 textParagraph
가 포함된 CardSection
의 예입니다.
위젯:
영구 바닥글 추가
CardFixedFooter
위젯은 개발자가 보내는 대화상자 메시지의 바닥글을 나타냅니다.
채팅 앱
바닥글에는 기본 버튼과 보조 버튼을 포함할 수 있습니다.
CardFixedFooter
위젯은
대화상자가 있습니다.
다음은 버튼이 두 개인 CardFixedFooter
위젯의 예입니다.
문제 해결
Google Chat 앱 또는 card가 오류를 반환하는 경우 Chat 인터페이스에 '문제가 발생했습니다'라는 메시지가 표시됨 또는 '요청을 처리할 수 없습니다'와 같은 메시지가 표시됩니다. 채팅 UI가 오류 메시지가 표시되지 않지만 채팅 앱 또는 카드에서 예기치 않은 결과가 발생합니다. 예를 들어 카드 메시지가 나타납니다.
채팅 UI에 오류 메시지가 표시되지 않을 수도 있지만 오류 해결에 도움이 되는 오류 메시지 및 로그 데이터를 사용할 수 있음 채팅 앱의 오류 로깅이 사용 설정된 경우 보는 데 도움이 필요한 경우 오류를 수정하는 방법에 대한 자세한 내용은 Google Chat 오류 문제 해결하기