Chat 앱에서는 지원되지 않습니다. Chat 앱에서도 곧 지원될 예정입니다.
DateTimePicker 위젯을 사용하면 사용자가 날짜, 시간 또는 날짜와 시간을 모두 지정할 수 있습니다.
사용자의 텍스트 입력은 허용되지만 사용자가 날짜 및 시간을 입력하는 데 도움이 되는 대화형 날짜 및 시간 선택기가 제공됩니다. 사용자가 날짜 또는 시간을 잘못 입력하면 위젯에 올바른 형식을 입력하라는 오류 메시지가 표시됩니다.
채팅 앱은 양식 입력 이벤트 중에 사용자가 입력한 날짜 및 시간 값을 수신하고 처리할 수 있습니다. 양식 입력 작업에 대한 자세한 내용은 양식 데이터 수신을 참고하세요.
예
다음 이미지는 DateTimePicker 위젯으로 구성된 카드를 보여줍니다.
DateTimePicker 위젯 세 개를 보여주는 Google Chat의 카드 메시지
카드의 JSON은 다음과 같습니다.
JSON
{
"cardsV2": [
{
"cardId": "exampleCard",
"card": {
"sections": [
{
"widgets": [
{
"textParagraph": {
"text": "A datetime picker widget with both date and time:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "meeting",
"type": 'DATE_AND_TIME',
}
},
{
"textParagraph": {
"text": "A datetime picker widget with just date:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "Choose a date",
"type": 'DATE_ONLY',
}
},
{
"textParagraph": {
"text": "A datetime picker widget with just time:"
}
},
{
"divider": {}
},
{
"dateTimePicker": {
"name": "date_time_picker_date_and_time",
"label": "Select a time",
"type": 'TIME_ONLY',
}
},
]
}
]
}
}
]
}
DateTimePicker JSON 표현 및 필드
| JSON 표현 |
|---|
{ "name": string, "label": string, "type": enum ( |
| 필드 | |
|---|---|
name
|
양식 입력 이벤트에서 날짜/시간 선택 도구가 식별되는 이름입니다. 양식 입력 작업에 관한 자세한 내용은 양식 데이터 수신 을 참고하세요. |
label
|
사용자에게 날짜, 시간 또는 날짜/시간을 입력하라는 메시지를 표시하는 텍스트입니다. 사용자가 앱에 필요한 정보를 입력하는 데 도움이 되는 텍스트를 지정합니다. 예를 들어 사용자가 약속을 설정하는 경우 '약속 날짜' 또는 '약속 날짜 및 시간'과 같은 라벨이 적합합니다. |
type
|
날짜/시간 선택 도구에서 지원하는 날짜 및 시간 유형 |
valueMsEpoch
|
사용자 입력 또는 이전 사용자 입력 이전의 기본값으로 표시되는 값으로, 밀리초( 에포크 시간 )로 표시됩니다.
|
timezoneOffsetDate
|
UTC 기준의 시간대 오프셋을 나타내는 숫자입니다. 설정된 경우 |
onChangeAction
|
사용자가 날짜/시간 선택 도구에서 저장 또는 삭제를 클릭하면 트리거됩니다. |
DateTimePickerType
| 열거형 | |
|---|---|
DATE_AND_TIME
|
사용자가 날짜와 시간을 선택할 수 있습니다. |
DATE_ONLY
|
사용자는 날짜만 선택할 수 있습니다. |
TIME_ONLY
|
사용자는 시간만 선택할 수 있습니다. |
Action
양식 제출 시의 동작을 설명하는 작업입니다. 예를 들어 Apps Script를 호출하여 양식을 처리할 수 있습니다. 작업이 트리거되면 양식 값이 서버로 전송됩니다.
| JSON 표현 |
|---|
{ "function": string, "parameters": [ { object ( |
| 필드 | |
|---|---|
function
|
포함하는 요소가 클릭되거나 부정확하게 활성화된 경우 호출할 맞춤 함수입니다. 사용 예는 대화형 카드 만들기 를 참조하세요. |
parameters[]
|
작업 매개변수 목록입니다. |
loadIndicator
|
작업을 호출하는 동안 작업에 표시되는 로드 표시기를 지정합니다. |
persistValues
|
작업 후 양식 값이 유지되는지 여부를 나타냅니다. 기본값은
|
interaction
|
선택사항. 대화상자 를 열 때 필요합니다. 사용자와의 상호작용에 따른 조치(예: 사용자가 카드 메시지의 버튼을 클릭하는 경우)
지정하지 않으면 앱은 정상적으로 링크 열기 또는 함수 실행과 같은
지정된 경우 로드 표시기는 표시되지 않습니다. Chat 앱에서는 지원되지만 Google Workspace 부가기능에서는 지원되지 않습니다. 부가기능에 지정하는 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다. |
ActionParameter
작업 메서드가 호출될 때 제공할 문자열 매개변수의 목록입니다. 예를 들어 다시 알림 버튼 3개(지금 일시중지, 1일 일시중지, 다음 주 다시 알림)를 사용하는 것이 좋습니다. 문자열 매개변수 목록에 다시 알림 유형 및 다시 알림 시간을 전달하여 작업 메서드 = pause()를 사용할 수 있습니다.
자세한 내용은 CommonEventObject 를 참조하세요.
| JSON 표현 |
|---|
{ "key": string, "value": string } |
| 필드 | |
|---|---|
key
|
액션 스크립트에 해당하는 매개변수의 이름입니다. |
value
|
매개변수 값입니다. |
LoadIndicator
작업을 호출하는 동안 작업에 표시되는 로드 표시기를 지정합니다.
| 열거형 | |
|---|---|
SPINNER
|
콘텐츠가 로드 중임을 나타내는 스피너를 표시합니다. |
NONE
|
아무것도 표시되지 않습니다. |
Interaction
선택사항. 대화상자 를 열 때 필요합니다.
사용자와의 상호작용에 따른 조치(예: 사용자가 카드 메시지의 버튼을 클릭하는 경우)
지정하지 않으면 앱은 정상적으로 링크 열기 또는 함수 실행과 같은
action
를 실행하여 응답합니다.
interaction
를 지정하면 앱이 특별한 대화형 방식으로 응답할 수 있습니다. 예를 들어
interaction
를
OPEN_DIALOG
로 설정하면 앱이
대화상자
를 열 수 있습니다.
지정된 경우 로드 표시기는 표시되지 않습니다.
Chat 앱에서는 지원되지만 Google Workspace 부가기능에서는 지원되지 않습니다. 부가기능에 지정하는 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다.
| 열거형 | |
|---|---|
INTERACTION_UNSPECIFIED
|
기본값
action
는 정상적으로 실행됩니다.
|
OPEN_DIALOG
|
채팅 앱이 사용자와 상호작용하는 데 사용하는 창 형식의 카드 기반 인터페이스인 대화상자 를 엽니다. 카드 메시지의 버튼 클릭에 응답하여 채팅 앱에서만 지원됩니다. Google Workspace 부가기능에서는 지원되지 않습니다. 부가기능에 지정하는 경우 전체 카드가 삭제되고 클라이언트에 아무것도 표시되지 않습니다. |