Pytanie, które umożliwia użytkownikowi wybranie jednej opcji z numerowanego ciągu przycisków opcji. Dostęp do elementów można uzyskać lub tworzyć je z poziomu Form. Jeśli są używane w teście, te elementy podlegają ocenie.
// Open a form by ID and add a new scale item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
create | Item | Tworzy nowy Item dla tego elementu skali. |
duplicate() | Scale | Tworzy kopię tego elementu i dołącza ją na końcu formularza. |
get | Quiz | Zwraca opinię, która jest wyświetlana osobom odpowiadającym na pytanie podlegające ocenie. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak Image, Page i Section). |
get | Integer | Pobiera unikalny identyfikator elementu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | String | Pobiera etykietę dolnej granicy skali, jeśli taka istnieje. |
get | Integer | Pobiera dolną granicę skali. |
get | Integer | Zwraca liczbę punktów elementu podlegającego ocenie. |
get | String | Pobiera etykietę górnej granicy skali, jeśli taka istnieje. |
get | String | Pobiera tytuł elementu (w przypadku Section czasami nazywany tekstem nagłówka). |
get | Item | Pobiera typ elementu reprezentowany jako Item. |
get | Integer | Pobiera górną granicę skali. |
is | Boolean | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Scale | Ustawia dolną i górną granicę skali. |
set | Scale | Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania). |
set | Scale | Ustawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak Image, Page i Section). |
set | Scale | Ustawia etykiety dolnej i górnej granicy skali. |
set | Scale | Ustawia liczbę punktów, jaką jest warta oceniana pozycja. |
set | Scale | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Scale | Ustawia tytuł elementu (w przypadku Section czasami nazywany tekstem nagłówka). |
Szczegółowa dokumentacja
createResponse(response)
Tworzy nowy ItemResponse dla tego elementu skali. Zgłasza wyjątek, jeśli argument response wykracza poza zakres ustawiony dla elementu.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
response | Integer | wartość odpowiedzi dla tego elementu skali. |
Powrót
ItemResponse – odpowiedź dotycząca elementu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 tego ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 osobom odpowiadającym na pytanie podlegające ocenie.
Powrót
QuizFeedback|null – opinia (jeśli występuje).
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
Powrót
String – tekst pomocy lub opis elementu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego 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 użyciem co najmniej jednego 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 taka istnieje.
Powrót
String – etykieta dolnej granicy skali
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getPoints()
Zwraca liczbę punktów elementu podlegającego ocenie.
Powrót
Integer – liczba punktów za pytanie.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 taka istnieje.
Powrót
String – etykieta górnej granicy skali.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Pobiera tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
Powrót
String – tytuł lub tekst nagłówka produktu.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isRequired()
Określa, czy respondent musi odpowiedzieć na pytanie.
Powrót
Boolean – czy respondent musi odpowiedzieć na pytanie;
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setBounds(lower, upper)
Ustawia dolną i górną granicę 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 ma domyślnie dolną granicę 1 i górną granicę 5.
Zgłasza wyjątek skryptu, jeśli podane wartości wykraczają poza dozwolone limity. Liczby dziesiętne są obcinane do poprzedzającej je liczby całkowitej.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
lower | Integer | nowa dolna granica, |
upper | Integer | nowa górna granica, |
Powrót
ScaleItem – ten ScaleItem do łączenia
Rzuty
Error – jeśli dolna lub górna granica jest nieprawidłowa.
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Ustawia informacje zwrotne, które mają być wyświetlane użytkownikom, gdy odpowiadają na pytanie podlegające ocenie, które nie ma prawidłowej ani nieprawidłowej odpowiedzi (np. pytania wymagające ręcznego oceniania).
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
feedback | Quiz | nowa opinia. |
Powrót
ScaleItem – ten ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Ustawia tekst pomocy dotyczący 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, |
Powrót
ScaleItem – ten ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 – ten ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
Ustawia liczbę punktów, jaką jest warta oceniana pozycja. Wartość domyślna dla nowych elementów to 0.
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
points | Integer | liczbę punktów, jaką jest warta pozycja pytania; |
Powrót
ScaleItem – ten ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 odpowiedzieć na pytanie; |
Powrót
ScaleItem – bieżący element (do łączenia w łańcuch)
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Ustawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
Parametry
| Nazwa | Typ | Opis |
|---|---|---|
title | String | nowy tytuł lub tekst nagłówka; |
Powrót
ScaleItem – ten ScaleItem do łączenia
Autoryzacja
Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms