Element pytania, który pozwala respondentowi wybrać jedną opcję z ponumerowanej sekwencji radia
przyciskami. Elementy można otwierać i tworzyć na koncie Form
. Te elementy użyte w quizie
są oceniane.
// Open a form by ID and add a new scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createResponse(response) | ItemResponse | Tworzy nową wartość ItemResponse dla tej wagi. |
duplicate() | ScaleItem | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
getGeneralFeedback() | QuizFeedback | Zwraca informację zwrotną, która jest wyświetlana respondentom podczas odpowiadania na pytanie, które można ocenić. |
getHelpText() | String | Pobiera tekst pomocy dotyczący elementu (nazywany czasem opisem 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 w formularzu. |
getLeftLabel() | String | Pobiera etykietę dolnej granicy skali, jeśli istnieje. |
getLowerBound() | Integer | Pobiera dolną granicę skali. |
getPoints() | Integer | Zwraca wartość punktową elementu podlegającego ocenie. |
getRightLabel() | String | Pobiera etykietę górnej granicy skali, jeśli istnieje. |
getTitle() | String | Pobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu reprezentowany przez ItemType . |
getUpperBound() | Integer | Pobiera górną granicę skali. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setBounds(lower, upper) | ScaleItem | Ustawia dolne i górne granice skali. |
setGeneralFeedback(feedback) | ScaleItem | Ustawia informację, że odpowiedzi będą wyświetlane respondentom, gdy odpowiedzą na pytanie podlegające ocenie, które nie ma poprawnej lub nieprawidłowej odpowiedzi (np. pytania, które wymagają ręcznego oceniania). |
setHelpText(text) | ScaleItem | Ustawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems , PageBreakItems i SectionHeaderItems ). |
setLabels(lower, upper) | ScaleItem | Ustawia etykiety dolnej i górnej granicy skali. |
setPoints(points) | ScaleItem | Określa liczbę punktów wartą oceniany element. |
setRequired(enabled) | ScaleItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | ScaleItem | Określa tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka). |
Szczegółowa dokumentacja
createResponse(response)
Tworzy nową wartość ItemResponse
dla tej wagi. Zgłasza wyjątek, jeśli argument response
znajduje się poza granicami elementu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | Integer | odpowiedź wartości dla tego elementu na skali |
Powrót
ItemResponse
– odpowiedź dotycząca produktu,
Autoryzacja
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.
Powrót
ScaleItem
– duplikat kodu ScaleItem
, na potrzeby tworzenia łańcuchów;
Autoryzacja
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 informację zwrotną, która jest wyświetlana respondentom podczas odpowiadania na pytanie, które można ocenić.
Powrót
QuizFeedback
– ewentualne opinie.
Autoryzacja
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 (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Powrót
String
– tekst pomocy dotyczący produktu lub opis.
Autoryzacja
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.
Powrót
Integer
– identyfikator produktu,
Autoryzacja
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 w formularzu.
Powrót
Integer
– indeks elementu,
Autoryzacja
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
getLeftLabel()
Pobiera etykietę dolnej granicy skali, jeśli istnieje.
Powrót
String
– etykieta dolnej granicy skali.
Autoryzacja
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
getLowerBound()
Pobiera dolną granicę skali.
Powrót
Integer
– dolna granica skali.
Autoryzacja
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.
Powrót
Integer
– liczba punktów warte dane pytanie.
Autoryzacja
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
getRightLabel()
Pobiera etykietę górnej granicy skali, jeśli istnieje.
Powrót
String
– etykieta górnej granicy skali.
Autoryzacja
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 SectionHeaderItem
nazywany tekstem nagłówka).
Powrót
String
– tytuł lub tekst nagłówka elementu;
Autoryzacja
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()
getUpperBound()
Pobiera górną granicę skali.
Powrót
Integer
– górna granica skali.
Autoryzacja
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.
Powrót
Boolean
– czy użytkownik musi odpowiedzieć na pytanie.
Autoryzacja
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
setBounds(lower, upper)
Ustawia dolne i górne granice skali. Dolna granica musi wynosić 0
lub 1
.
górna granica musi mieścić się w zakresie od 3
do 10
włącznie. Nowa skala domyślnie przyjmuje
dolna granica kolumny 1
i górna wynosząca 5
.
Zgłasza wyjątek skryptu, jeśli podane wartości wykraczają poza dozwolone limity. Ułamki dziesiętne są obcinane do poprzedniej liczby całkowitej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
lower | Integer | nowa dolna granica |
upper | Integer | nowa górna granica |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Rzuty
Error
– jeśli dolna lub górna granica jest nieprawidłowa;
Autoryzacja
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)
Ustawia informację, że odpowiedzi będą wyświetlane respondentom, gdy odpowiedzą na pytanie podlegające ocenie, które nie ma poprawnej lub nieprawidłowej odpowiedzi (np. pytania, które wymagają ręcznego oceniania).
Parametry
Nazwa | Typ | Opis |
---|---|---|
feedback | QuizFeedback | nowa opinia |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Autoryzacja
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 elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems
, PageBreakItems
i SectionHeaderItems
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Autoryzacja
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
setLabels(lower, upper)
Ustawia etykiety dolnej i górnej granicy skali.
Parametry
Nazwa | Typ | Opis |
---|---|---|
lower | String | nowa etykieta dolnej granicy |
upper | String | nowa etykieta górnej granicy |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Autoryzacja
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 wartą oceniany element. Wartość domyślna nowych elementów to 0.
Parametry
Nazwa | Typ | Opis |
---|---|---|
points | Integer | liczba punktów warta przedmiot pytania |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Autoryzacja
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, |
Powrót
ScaleItem
– bieżący element (do tworzenia łańcuchów),
Autoryzacja
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)
Określa tytuł elementu (w przypadku SectionHeaderItem
nazywany też tekstem nagłówka).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka; |
Powrót
ScaleItem
– ScaleItem
, łańcuch
Autoryzacja
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