Class ScaleItem

SkalaArtykuł

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
createResponse(response)	ItemResponse	Tworzy nowy element ItemResponse dla tej wagi.
duplicate()	ScaleItem	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.
getLeftLabel()	String	Pobiera etykietę dolnej granicy skali (jeśli istnieje).
getLowerBound()	Integer	Pobiera dolną granicę skali.
getPoints()	Integer	Zwraca liczbę punktów za element, który można ocenić.
getRightLabel()	String	Pobiera etykietę górnej granicy skali (jeśli istnieje).
getTitle()	String	Pobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()	ItemType	Pobiera typ elementu jako ItemType.
getUpperBound()	Integer	Pobiera górną granicę skali.
isRequired()	Boolean	Określa, czy respondent musi odpowiedzieć na pytanie.
setBounds(lower, upper)	ScaleItem	Ustawia dolną i górną granicę skali.
setGeneralFeedback(feedback)	ScaleItem	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ęcznego oceniania).
setHelpText(text)	ScaleItem	Ustawia tekst pomocy elementu (czasami nazywany tekstem opisu dla 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, które można przyznać ocenianemu elementowi.
setRequired(enabled)	ScaleItem	Określa, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)	ScaleItem	Ustawia tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Szczegółowa dokumentacja

createResponse(response)

Tworzy nowy element ItemResponse 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

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

ScaleItem – duplikat tego elementu ScaleItem, 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

---

getLeftLabel()

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

---

getLowerBound()

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

---

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

---

getRightLabel()

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

---

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()

Pobiera typ elementu jako ItemType.

Powrót

ItemType – typ 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

---

getUpperBound()

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

---

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

---

setBounds(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

ScaleItem – ta ScaleItem, 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

---

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ęcznego oceniania).

Parametry

Nazwa	Typ	Opis
feedback	QuizFeedback	nowe opinie

Powrót

ScaleItem – ta ScaleItem, 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

ScaleItem – ta ScaleItem, 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

---

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 – ta ScaleItem, 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

ScaleItem – ta ScaleItem, 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

ScaleItem – 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ł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Parametry

Nazwa	Typ	Opis
title	String	nowy tytuł lub tekst nagłówka.

Powrót

ScaleItem – ta ScaleItem, 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