Element pytania, który umożliwia użytkownikowi wskazanie daty i godziny. Aby uzyskać dostęp do elementów lub utworzyć je, kliknij Form
. W przypadku testów te elementy są oceniane.
// Open a form by ID and add a new date-time item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDateTimeItem(); item.setTitle('When do you want to meet?');
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createResponse(response) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu daty i godziny. |
duplicate() | DateTimeItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getGeneralFeedback() | QuizFeedback | Zwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić. |
getHelpText() | String | Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator elementu. |
getIndex() | Integer | Pobiera indeks elementu spośród wszystkich elementów formularza. |
getPoints() | Integer | Zwraca wartość punktową elementu podlegającego ocenie. |
getTitle() | String | Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu, reprezentowany jako ItemType . |
includesYear() | Boolean | Określa, czy element daty zawiera opcję roku. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setGeneralFeedback(feedback) | DateTimeItem | Określa informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej). |
setHelpText(text) | DateTimeItem | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setIncludesYear(enableYear) | DateTimeItem | Określa, czy element daty zawiera ustawienie roku. |
setPoints(points) | DateTimeItem | Określa liczbę punktów za element, który można ocenić. |
setRequired(enabled) | DateTimeItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | DateTimeItem | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
Szczegółowa dokumentacja
createResponse(response)
Tworzy nowy element ItemResponse
dla tego elementu daty i godziny. Pole sekund obiektu Date
jest ignorowane. Domyślnie używane są pola roku, miesiąca, dnia, godziny i minuty. Jeśli setIncludesYear(enabled)
ma wartość false
, rok również jest ignorowany.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | Date | obiekt Date reprezentujący miesiąc, dzień, godzinę, minutę i prawdopodobnie rok |
Powroty
ItemResponse
– odpowiedź dotycząca produktu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Tworzy kopię tego elementu i dołącza ją na końcu formularza.
Powroty
DateTimeItem
– duplikat elementu DateTimeItem
na potrzeby łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Zwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
Powroty
QuizFeedback
– ewentualna opinia.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Pobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powroty
String
– tekst pomocy lub opis dotyczący produktu.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Pobiera unikalny identyfikator elementu.
Powroty
Integer
– identyfikator produktu,
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Pobiera indeks elementu spośród wszystkich elementów formularza.
Powroty
Integer
– indeks elementu;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Zwraca wartość punktową elementu podlegającego ocenie.
Powroty
Integer
– liczba punktów, za jaką pytanie jest warte pytanie.
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Pobiera tytuł elementu (w przypadku elementu SectionHeaderItem
jest czasami nazywany tekstem nagłówka).
Powroty
String
– tytuł lub tekst nagłówka elementu;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
includesYear()
Określa, czy element daty zawiera opcję roku.
Powroty
Boolean
– true
, jeśli data zawiera ustawienie roku; w przeciwnym razie false
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
isRequired()
Określa, czy użytkownik musi odpowiedzieć na pytanie.
Powroty
Boolean
– czy użytkownik musi odpowiedzieć na pytanie;
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Określa informacje, które będą wyświetlane respondentom, gdy odpowiadają na pytanie, które można ocenić, ale na które nie ma prawidłowej lub niepoprawnej odpowiedzi (np. na pytanie, które wymaga oceny ręcznej).
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowa opinia |
Powroty
DateTimeItem
– ten DateTimeItem
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Powroty
DateTimeItem
– ten DateTimeItem
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIncludesYear(enableYear)
Określa, czy element daty zawiera ustawienie roku. Wartość domyślna nowych elementów daty to true
.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enableYear | Boolean | true , jeśli data zawiera ustawienie roku; w przeciwnym razie false |
Powroty
DateTimeItem
– ten DateTimeItem
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Określa liczbę punktów za element, który można ocenić. Wartość domyślna nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów wartych pytania |
Powroty
DateTimeItem
– ten DateTimeItem
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Określa, czy użytkownik musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi odpowiedzieć na pytanie, |
Powroty
DateTimeItem
– bieżący element (na potrzeby łańcuszków)
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem
jest czasami nazywany tekstem nagłówka).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powroty
DateTimeItem
– ten DateTimeItem
, do łańcuchów
Upoważnienie
Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms