Widżet DateTimePicker
umożliwia użytkownikom wpisywanie daty, godziny lub zarówno daty, jak i godziny.
Użytkownicy mogą wprowadzić tekst lub wybrać datę i godzinę przy użyciu selektora. Jeśli użytkownicy wprowadzą nieprawidłową datę lub godzinę, selektor wyświetli błąd i wyświetli prośbę o poprawne wpisanie informacji.
Informacje o przetwarzaniu wartości daty i godziny wpisane przez użytkowników znajdziesz w artykule Odbieranie danych z formularza.
Przykład
Poniżej znajdziesz kartę składającą się z 3 różnych typów widżetów DateTimePicker
:
Reprezentacja i pola w formacie JSON
Zapis JSON |
---|
{ "name": string, "label": string, "type": enum ( |
Pola | |
---|---|
name
|
Nazwa, dzięki której Więcej informacji o pracy z danymi wejściowymi w formularzach znajdziesz w sekcji Odbieranie danych formularzy. |
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 |
type
|
Określa, czy widżet obsługuje wpisywanie daty, godziny czy daty i godziny. |
valueMsEpoch
|
Wartość domyślna wyświetlana w widżecie w milisekundach od czasu uniksowego.
Określ wartość na podstawie typu selektora (
|
timezoneOffsetDate
|
Liczba określająca przesunięcie strefy czasowej względem UTC (w minutach). Jeśli zasada jest skonfigurowana, |
onChangeAction
|
Wywoływane, gdy użytkownik kliknie Zapisz lub Wyczyść w interfejsie |
Typ elementu DateTimePicker
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ę. |
Działanie
Działanie opisujące zachowanie po przesłaniu formularza. Możesz na przykład wywołać skrypt Apps Script do obsługi formularza. W przypadku wywołania działania wartości formularza są przesyłane na serwer.
Zapis JSON |
---|
{ "function": string, "parameters": [ { object ( |
Pola | |
---|---|
function
|
Funkcja niestandardowa wywoływana po kliknięciu elementu zawierającego nazwę lub po jego włączeniu. Przykład użycia znajdziesz w artykule Tworzenie kart interaktywnych. |
parameters[]
|
Lista parametrów działań. |
loadIndicator
|
Określa wskaźnik wczytywania, który wyświetla się podczas wywoływania działania. |
persistValues
|
Wskazuje, czy wartości formularza pozostają po wykonaniu działania. Wartością domyślną jest
Jeśli
Jeśli |
interaction
|
Opcjonalnie. Wymagane przy otwieraniu okna. Co ma zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w komunikacie na karcie.
Jeśli nie określono inaczej, aplikacja odpowiada, wykonując
Dzięki określeniu właściwości Jest obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz, że to dodatek, karta zostanie usunięta w całości i nic nie będzie wyświetlane w kliencie. |
Parametr ActionParametr
Lista parametrów ciągów tekstowych, które należy dostarczyć po wywołaniu metody działania. Dostępne są na przykład trzy przyciski drzemki: Odłóż teraz, Odłóż na jeden dzień lub Drzemka w kolejnym tygodniu. Możesz użyć funkcji action method = snooze()
, która przekazuje 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 wczytywania
Określa wskaźnik wczytywania, który wyświetla się podczas wywoływania działania.
Wartości w polu enum | |
---|---|
SPINNER
|
Wskaźnik postępu ładowania treści. |
NONE
|
Nic nie jest wyświetlane. |
Interakcja
Opcjonalnie. Wymagane przy otwieraniu okna.
Co ma zrobić w odpowiedzi na interakcję z użytkownikiem, np. kliknięcie przez niego przycisku w komunikacie na karcie.
Jeśli nie określono inaczej, aplikacja odpowiada, wykonując action
(np. otwierając link lub uruchamiając funkcję) w zwykły sposób.
Dzięki określeniu właściwości interaction
aplikacja może reagować w specjalny, interaktywny sposób. Jeśli na przykład ustawisz interaction
na OPEN_DIALOG
, aplikacja będzie mogła otworzyć okno.
Jeśli jest określony, wskaźnik wczytywania się nie wyświetla.
Jest obsługiwane przez aplikacje do obsługi czatu, ale nie przez dodatki do Google Workspace. Jeśli określisz, że to dodatek, karta zostanie usunięta w całości i nic nie będzie wyświetlane w kliencie.
Wartości w polu enum | |
---|---|
INTERACTION_UNSPECIFIED
|
Wartość domyślna. action działa normalnie.
|
OPEN_DIALOG
|
Otwiera okno, czyli interfejs z kartami, za pomocą którego aplikacje do obsługi czatu kontaktują się z użytkownikami. Obsługiwane tylko przez aplikacje do obsługi czatu w odpowiedzi na kliknięcia przycisków w wiadomościach z kartą. Nieobsługiwane przez dodatki do Google Workspace. Jeśli określisz, że to dodatek, karta zostanie usunięta w całości i nic nie będzie wyświetlane w kliencie. |
Rozwiązywanie problemów
Gdy aplikacja lub karta do Google Chat zwróci błąd, w interfejsie czatu pojawi się komunikat „Coś poszło nie tak” lub „Nie udało się przetworzyć żądania”. Czasami w interfejsie Google Chat nie pojawia się żaden komunikat o błędzie, ale aplikacja lub karta Google Chat zwraca nieoczekiwany wynik, np. może się nie pojawić wiadomość na karcie.
Mimo że komunikat o błędzie może nie wyświetlać się w interfejsie Google Chat, dostępne są opisowe komunikaty o błędach i dane dziennika, które pomogą Ci w rozwiązywaniu problemów pojawiających się po włączeniu rejestrowania błędów w aplikacjach do obsługi czatu. Informacje o wyświetlaniu, debugowaniu i naprawianiu błędów znajdziesz w artykule Rozwiązywanie problemów z Google Chat i ich rozwiązywanie.