Pole do wprowadzania danych, które umożliwia użytkownikom wpisanie daty i godziny.
Obsługuje weryfikację przesłanych formularzy. Gdy parametr Action.setAllWidgetsAreRequired(allWidgetsAreRequired) ma wartość true lub ten widżet jest określony za pomocą parametru Action.addRequiredWidget(requiredWidget), przesłanie jest blokowane, chyba że zostanie wybrana wartość.
Dostępne w przypadku dodatków do Google Workspace i aplikacji do Google Chat.
const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') // Set default value as Jan 1, 2018, 3:00 AM UTC. Either a number or // string is acceptable. .setValueInMsSinceEpoch(1514775600) // EDT time is 5 hours behind UTC. .setTimeZoneOffsetInMins(-5 * 60) .setOnChangeAction( CardService.newAction().setFunctionName('handleDateTimeChange'), );
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
add | Widget | Dodaje działanie związane z wydarzeniem, które można wykonać w widżecie. |
set | Date | Ustawia nazwę pola, które identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem. |
set | Date | W agencie Google Workspace Studio pozwól zmiennym wejściowym akceptować dane wyjściowe daty i godziny z innych kroków agenta. |
set | Widget | Ustawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony. |
set | Date | Ustawia Action, które skrypt wykonuje za każdym razem, gdy zmienia się dane wejściowe selektora. |
set | Date | Ustawia liczbę minut, o którą strefa czasowa powinna być przesunięta względem czasu UTC. |
set | Date | Ustawia tytuł wyświetlany nad polem wprowadzania. |
set | Date | Ustawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym. |
set | Date | Ustawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym. |
set | Widget | Ustawia widoczność widżetu. |
Szczegółowa dokumentacja
add
Dodaje działanie związane z wydarzeniem, które można wykonać w widżecie.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
event | Event | Event do dodania. |
Powrót
Widget – obiekt do łączenia.
set
Ustawia nazwę pola, które identyfikuje ten selektor w obiekcie zdarzenia generowanym podczas interakcji z interfejsem. Nazwa pola jest widoczna dla użytkownika. Wymagane; podana nazwa pola musi być niepowtarzalna.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
field | String | Nazwa, którą chcesz przypisać do tego wejścia. |
Powrót
Date – ten selektor do łączenia.
set
W agencie Google Workspace Studio pozwól zmiennym wejściowym akceptować dane wyjściowe daty i godziny z innych kroków agenta. Możesz na przykład otrzymać informację o godzinie wysłania wiadomości w Gmailu lub dacie zaplanowania wydarzenia w Kalendarzu.
Dostępne tylko w przypadku dodatków do Google Workspace, które rozszerzają Google Workspace Studio.
const workflowDataSource = CardService.newWorkflowDataSource().setIncludeVariables(true); const hostAppDataSource = CardService.newHostAppDataSource().setWorkflowDataSource(workflowDataSource); const dateTimePicker = CardService.newDateTimePicker() .setTitle('Enter the date and time.') .setFieldName('date_time_field') .setHostAppDataSource(hostAppDataSource);
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
host | Host | Źródło danych. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia unikalny identyfikator przypisany do widżetu, który ma zostać zmieniony. Modyfikacja widżetu jest obsługiwana tylko w dodatkach.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
id | String | Identyfikator widżetu, który może mieć maksymalnie 64 znaki i musi być zgodny z formatem `[a-zA-Z0-9-]+`. |
Powrót
Widget – ten obiekt do łączenia.
set
Ustawia Action, które skrypt wykonuje za każdym razem, gdy zmienia się dane wejściowe selektora.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
action | Action | Działanie do wykonania. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia liczbę minut, o którą strefa czasowa powinna być przesunięta względem czasu UTC. Jeśli ta opcja jest ustawiona, data i godzina są wyświetlane w określonej strefie czasowej. Jeśli nie jest ustawiona, godzina jest wyświetlana w strefie czasowej użytkownika.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
time | Integer | Liczba minut, o którą strefa czasowa jest przesunięta względem czasu UTC. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia tytuł wyświetlany nad polem wprowadzania.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
title | String | Tytuł pola do wprowadzania danych. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | Number | Wartość domyślna umieszczona w polu wejściowym jako liczba w milisekundach od początku epoki. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia wstępnie wypełnioną wartość, która ma zostać ustawiona w polu wejściowym.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
value | String | Wartość domyślna umieszczona w polu wejściowym jako ciąg znaków w milisekundach od początku epoki. W parametrach wywołania zwrotnego formularza jest zawsze reprezentowany jako ciąg tekstowy. |
Powrót
Date – ten selektor do łączenia.
set
Ustawia widoczność widżetu. Wartością domyślną jest „VISIBLE”.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
visibility | Visibility | Visibility widżetu. |
Powrót
Widget – obiekt do łączenia.