Element pytania, który umożliwia respondentowi wskazanie pory dnia. Elementy można tworzyć i do nich uzyskiwać dostęp z poziomu Form
. Gdy są używane w teście, są oceniane.
// Open a form by ID and add a new time item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const 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 dodaje ją na końcu formularza. |
getGeneralFeedback() | QuizFeedback | Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane. |
getHelpText() | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
getId() | Integer | Pobiera unikalny identyfikator produktu. |
getIndex() | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
getPoints() | Integer | Zwraca liczbę punktów za element, który można ocenić. |
getTitle() | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem ). |
getType() | ItemType | Pobiera typ elementu jako ItemType . |
isRequired() | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
setGeneralFeedback(feedback) | TimeItem | Określa informacje zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznej oceny). |
setHelpText(text) | TimeItem | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setPoints(points) | TimeItem | Określa liczbę punktów, które można przyznać ocenianemu elementowi. |
setRequired(enabled) | TimeItem | Określa, czy respondent musi odpowiedzieć na pytanie. |
setTitle(title) | TimeItem | Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem ). |
Szczegółowa dokumentacja
createResponse(hour, minute)
Tworzy nowy element ItemResponse
dla tego elementu czasu. Argumenty hour
i minute
najlepiej reprezentować jako liczby całkowite z zakresu 0
–23
i z zakresu 0
–59
. Jeśli przekroczą te granice, zachowują się jak zegar: na przykład 10, 90
jest interpretowane jako 11:30, a -1, 60
jako 00:00.
Parametry
Nazwa | Typ | Opis |
---|---|---|
hour | Integer | godzinę, reprezentowaną jako liczba całkowita z zakresu od 0 do 23 |
minute | Integer | minuta godziny, reprezentowana jako liczba całkowita z zakresu 0 –59 |
Powrót
ItemResponse
– odpowiedź na element
Autoryzacja
Skrypty, które korzystają 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 dodaje ją na końcu formularza.
Powrót
TimeItem
– duplikat tego elementu TimeItem
, służący do łańcuchowania.
Autoryzacja
Skrypty, które korzystają 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 opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane.
Powrót
QuizFeedback
– opinia (jeśli została przesłana).
Autoryzacja
Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powrót
String
– tekst pomocy lub tekst opisu produktu,
Autoryzacja
Skrypty, które korzystają 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 produktu.
Powrót
Integer
– identyfikator produktu
Autoryzacja
Skrypty, które korzystają 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 w formularzu.
Powrót
Integer
– indeks elementu
Autoryzacja
Skrypty, które korzystają 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 liczbę punktów za element, który można ocenić.
Powrót
Integer
– liczba punktów, jaką można uzyskać za pytanie.
Autoryzacja
Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem
).
Powrót
String
– tytuł lub tekst nagłówka
Autoryzacja
Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.
Powrót
Boolean
– czy respondent musi odpowiedzieć na pytanie
Autoryzacja
Skrypty, które korzystają 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 zwrotne, które mają być wyświetlane respondentom, gdy odpowiadają na oceniane pytanie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (czyli pytania, które wymagają ręcznej oceny).
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowe opinie |
Powrót
TimeItem
– ta TimeItem
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
TimeItem
– ta TimeItem
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów za pytanie |
Powrót
TimeItem
– ta TimeItem
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
TimeItem
– bieżący element (do łańcuchowania).
Autoryzacja
Skrypty, które korzystają 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ł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
TimeItem
– ta TimeItem
, aby utworzyć łańcuch
Autoryzacja
Skrypty, które korzystają 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