Element pytania, który pozwala użytkownikowi określić porę dnia. 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 time item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addTimeItem(); item.setTitle('What time do you usually wake up in the morning?');
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createResponse(hour, minute) | ItemResponse | Tworzy nowy element ItemResponse dla tego elementu czasu. |
duplicate() | TimeItem | 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 . |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setGeneralFeedback(feedback) | TimeItem | 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) | TimeItem | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | TimeItem | Określa liczbę punktów za element, który można ocenić. |
setRequired(enabled) | TimeItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | TimeItem | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
Szczegółowa dokumentacja
createResponse(hour, minute)
Tworzy nowy element ItemResponse
dla tego elementu czasu. Argumenty hour
i minute
najlepiej przyjmują liczby całkowite od 0
do 23
i od 0
do 59
. Jeśli przekroczą te granice, zachowują się tak jak zegar: na przykład 10, 90
jest interpretowany jako 11:30, a -1, 60
– jako 00:00.
Parametry
Nazwa | Typ | Opis |
---|---|---|
hour | Integer | godzina w postaci liczby całkowitej od 0 do 23 |
minute | Integer | minuta godziny wyrażona jako liczba całkowita od 0 do 59 |
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
TimeItem
– duplikat elementu TimeItem
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()
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
TimeItem
– ten TimeItem
, 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
TimeItem
– ten TimeItem
, 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
TimeItem
– ten TimeItem
, 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
TimeItem
– 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
TimeItem
– ten TimeItem
, 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