Element pytania, który umożliwia respondentowi wybranie jednej opcji z ponumerowanych przycisków opcji. Elementy można tworzyć i otwierać w ramach Form
. Gdy są używane w teście, 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 element Item dla tej wagi. |
duplicate() | Scale | Tworzy kopię tego elementu i dodaje ją na końcu formularza. |
get | Quiz | Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane. |
get | String | Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
get | Integer | Pobiera unikalny identyfikator produktu. |
get | Integer | Pobiera indeks elementu spośród wszystkich elementów w formularzu. |
get | String | Pobiera etykietę dolnej granicy skali (jeśli istnieje). |
get | Integer | Pobiera dolną granicę skali. |
get | Integer | Zwraca liczbę punktów za element, który można ocenić. |
get | String | Pobiera etykietę górnej granicy skali (jeśli istnieje). |
get | String | Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section ). |
get | Item | Pobiera typ elementu 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 | 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). |
set | Scale | Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image , Page i Section ). |
set | Scale | Ustawia etykiety dolnej i górnej granicy skali. |
set | Scale | Określa liczbę punktów, które można przyznać ocenianemu elementowi. |
set | Scale | Określa, czy respondent musi odpowiedzieć na pytanie. |
set | Scale | Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku Section ). |
Szczegółowa dokumentacja
create Response(response)
Tworzy nowy element Item
dla tej wagi. Wyjątek jest zgłaszany, jeśli argument response
wykracza poza zakres określony dla elementu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | Integer | wartość odpowiedzi dla tego elementu skali. |
Powrót
Item
– 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
Scale
– duplikat tego elementu Scale
, 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
get General Feedback()
Zwraca opinię, która jest wyświetlana respondentom, gdy odpowiadają na pytanie oceniane.
Powrót
Quiz
– 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
get Help Text()
Pobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
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
get Id()
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
get Index()
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
get Left Label()
Pobiera etykietę dolnej granicy skali (jeśli istnieje).
Powrót
String
– etykieta dolnej granicy skali
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
get Lower Bound()
Pobiera dolną granicę skali.
Powrót
Integer
– dolna granica skali,
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
get Points()
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
get Right Label()
Pobiera etykietę górnej granicy skali (jeśli istnieje).
Powrót
String
– etykieta górnej granicy skali
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
get Title()
Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku Section
).
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
get Type()
get Upper Bound()
Pobiera górną granicę skali.
Powrót
Integer
– górna granica skali,
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
is Required()
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
set Bounds(lower, upper)
Ustawia dolną i górną granicę skali. Dolna granica musi być równa 0
lub 1
. Górna granica musi mieścić się w przedziale od 3
do 10
(włącznie). Nowa skala ma domyślnie dolną granicę 1
i górną granicę 5
.
Wyjątek skryptu, jeśli podane wartości wykraczają poza dozwolone limity. Liczby 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
Scale
– ta Scale
, aby utworzyć łańcuch
Rzuty
Error
– jeśli dolna lub górna granica jest nieprawidłowa.
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
set General Feedback(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 | Quiz | nowe opinie |
Powrót
Scale
– ta Scale
, 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
set Help Text(text)
Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak Image
, Page
i Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | nowy tekst pomocy. |
Powrót
Scale
– ta Scale
, 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
set Labels(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
Scale
– ta Scale
, 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
set Points(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
Scale
– ta Scale
, 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
set Required(enabled)
Określa, czy respondent musi odpowiedzieć na pytanie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
enabled | Boolean | czy respondent musi udzielić odpowiedzi na pytanie. |
Powrót
Scale
– 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
set Title(title)
Ustawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku Section
).
Parametry
Nazwa | Typ | Opis |
---|---|---|
title | String | nowy tytuł lub tekst nagłówka. |
Powrót
Scale
– ta Scale
, 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