Element pytania, który umożliwia respondentowi wybranie 1 opcji z sekwencji numerowanych przycisków. Elementy można otworzyć lub utworzyć za pomocą: Form
. W teście elementy te 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 nowy element (ItemResponse ) dla tego elementu wagi. |
duplicate() | ScaleItem | 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. |
getLeftLabel() | String | Pobiera etykietę dolnej granicy skali (jeśli istnieje). |
getLowerBound() | Integer | Pobiera dolną granicę wagi. |
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 elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
getType() | ItemType | Pobiera typ elementu, reprezentowany jako ItemType . |
getUpperBound() | Integer | Pobiera górną granicę wagi. |
isRequired() | Boolean | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setBounds(lower, upper) | ScaleItem | Określa dolną i górną granicę skali. |
setGeneralFeedback(feedback) | ScaleItem | 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) | ScaleItem | Ustawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu 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 za element, który można ocenić. |
setRequired(enabled) | ScaleItem | Określa, czy użytkownik musi odpowiedzieć na pytanie. |
setTitle(title) | ScaleItem | Ustawia tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka). |
Szczegółowa dokumentacja
createResponse(response)
Tworzy nowy element (ItemResponse
) dla tego elementu wagi. Zgłasza wyjątek, jeśli argument response
wykracza poza zakres ustalony dla tego elementu.
Parametry
Nazwa | Typ | Opis |
---|---|---|
response | Integer | odpowiedź wartości dla tego elementu skali |
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
ScaleItem
– duplikat elementu ScaleItem
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
getLeftLabel()
Pobiera etykietę dolnej granicy skali (jeśli istnieje).
Powroty
String
– etykieta dolnej granicy skali.
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
getLowerBound()
Pobiera dolną granicę wagi.
Powroty
Integer
– dolna granica skali.
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
getRightLabel()
Pobiera etykietę górnej granicy skali (jeśli istnieje).
Powroty
String
– etykieta górnej granicy skali.
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()
getUpperBound()
Pobiera górną granicę wagi.
Powroty
Integer
– górna granica skali.
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
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
setBounds(lower, upper)
Określa dolną i górną granicę skali. Dolna granica musi wynosić 0
lub 1
. Górna granica musi mieścić się w przedziale od 3
do 10
włącznie. Nowa skala przyjmuje domyślnie dolną granicę (1
) i górną (5
).
Jeśli podane wartości nie mieszczą się w dozwolonych granicach, powoduje zgłoszenie wyjątku dotyczącego skryptów. Miejsca dziesiętne są obcinane do poprzedzającej liczby całkowitej.
Parametry
Nazwa | Typ | Opis |
---|---|---|
lower | Integer | nowa dolna granica |
upper | Integer | nowa górna granica |
Powroty
ScaleItem
– ten ScaleItem
, do łańcuchów
Rzuty
Error
– jeśli dolna lub górna granica jest nieprawidłowa,
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
ScaleItem
– ten ScaleItem
, 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
ScaleItem
– ten ScaleItem
, 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
setLabels(lower, upper)
Ustawia etykiety dolnej i górnej granicy skali.
Parametry
Nazwa | Typ | Opis |
---|---|---|
lower | String | nowa etykieta dolnej granicy |
upper | String | nową etykietę górnej granicy |
Powroty
ScaleItem
– ten ScaleItem
, 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
ScaleItem
– ten ScaleItem
, 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
ScaleItem
– 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
ScaleItem
– ten ScaleItem
, 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