Widżet DateTimePicker umożliwia użytkownikom wpisywanie daty, godziny lub daty i godziny.
Użytkownicy mogą wprowadzać tekst lub wybierać daty i godziny za pomocą selektora. Jeśli użytkownicy wpiszą nieprawidłową datę lub godzinę, selektor wyświetli komunikat o błędzie informujący o tym, że dane są prawidłowe.
Aplikacje do obsługi czatu otrzymują i przetwarzają wartość dat i godzin wpisanych przez użytkownika podczas zdarzeń w formularzu. Szczegółowe informacje o korzystaniu z danych wejściowych formularza znajdziesz w artykule Odbieranie danych formularza.
Przykład
Ten obraz przedstawia kartę zawierającą widżet DateTimePicker:
DateTimePicker: jeden do wyboru daty, godziny, a drugi tylko do daty.
Oto kod JSON karty:
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",
}
},
]
}
]
}
}
]
}
Reprezentacja i pola JSON
| Zapis JSON |
|---|
{ "name": string, "label": string, "type": enum ( |
| Pola | |
|---|---|
name
|
Nazwa, za pomocą której określony jest element Więcej informacji na temat pracy z danymi z formularzy znajdziesz w artykule Odbieranie danych formularza. |
label
|
Tekst zachęcający użytkowników do wpisania daty, godziny lub daty i godziny. Jeśli na przykład użytkownicy planują spotkanie, użyj etykiety takiej jak |
type
|
Określa, czy widżet obsługuje wprowadzanie daty, godziny lub daty i godziny. |
valueMsEpoch
|
Wartość domyślna wyświetlana w widżecie w milisekundach od czasu uniksowego.
Określ wartość w zależności od typu selektora (
|
timezoneOffsetDate
|
Liczba określająca przesunięcie czasu względem strefy czasowej UTC w minutach. Jeśli zasada jest ustawiona, wartość |
onChangeAction
|
Wywoływane, gdy użytkownik kliknie Zapisz lub Wyczyść w interfejsie |
Typ daty i godziny
| Wartości w polu enum | |
|---|---|
DATE_AND_TIME
|
Użytkownicy wpisują datę i godzinę. |
DATE_ONLY
|
Użytkownicy wpisują datę. |
TIME_ONLY
|
Użytkownicy wpisują godzinę. |
Czynność
Działanie opisujące zachowanie podczas przesyłania formularza. Możesz na przykład wywołać skrypt Apps Script, aby obsłużyć formularz. Jeśli działanie zostanie aktywowane, wartości formularza zostaną przesłane na serwer.
| Zapis JSON |
|---|
{ "function": string, "parameters": [ { object ( |
| Pola | |
|---|---|
function
|
Funkcja niestandardowa, która ma być wywoływana po kliknięciu lub aktywowaniu elementu zawierającego. Więcej informacji znajdziesz w artykule Tworzenie interaktywnych kart. |
parameters[]
|
Lista parametrów działania. |
loadIndicator
|
Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania. |
persistValues
|
Wskazuje, czy po formularzu działanie formularza pozostaje aktywne. Wartością domyślną jest
Jeśli pole
Jeśli |
interaction
|
Opcjonalnie. Wymagane przy otwieraniu okna. Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając
Jeśli określisz Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie. |
Parametr działania
Lista parametrów ciągu znaków, które mają zostać podane po wywołaniu metody działania. Możesz np. wybrać 3 przyciski drzemki: drzemka teraz, drzemka na dzień lub drzemkę w przyszłym tygodniu. Można użyć właściwości action method = snooze(), przekazując typ drzemki i czas drzemki na liście parametrów ciągu znaków.
Więcej informacji: CommonEventObject.
| Zapis JSON |
|---|
{ "key": string, "value": string } |
| Pola | |
|---|---|
key
|
Nazwa parametru skryptu działania. |
value
|
Wartość parametru. |
Wskaźnik obciążenia
Określa wskaźnik wczytywania wyświetlany podczas wykonywania działania.
| Wartości w polu enum | |
|---|---|
SPINNER
|
Wyświetla wskaźnik postępu wczytywania treści. |
NONE
|
Nic nie jest wyświetlane. |
Interakcja
Opcjonalnie. Wymagane przy otwieraniu okna.
Co zrobić w odpowiedzi na interakcję użytkownika, np. kliknięcie przycisku w wiadomości na karcie.
Jeśli nie określono inaczej, aplikacja reaguje w zwykły sposób, uruchamiając action, np. otwierając link lub uruchamiając funkcję.
Jeśli określisz interaction, aplikacja może reagować w specjalny sposób. Jeśli na przykład ustawisz interaction na wartość OPEN_DIALOG, aplikacja będzie mogła otwierać okno.
Jeśli podasz wartość, wskaźnik ładowania się nie wyświetli.
Obsługiwane przez aplikacje do obsługi czatu, ale nie w ramach dodatków do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie.
| Wartości w polu enum | |
|---|---|
INTERACTION_UNSPECIFIED
|
Wartość domyślna. action działa normalnie.
|
OPEN_DIALOG
|
Otwiera okno – interfejs użytkownika w postaci okna, który umożliwia aplikacjom Google Chat interakcję z użytkownikami. Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcie przycisku na karcie. Nieobsługiwane przez dodatki do Google Workspace. Jeśli dodatek jest określony jako dodatek, cała karta jest usuwana i nic nie jest wyświetlane w kliencie. |