Class ScaleItem

ScaleItem

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

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nową wartość ItemResponse dla tej wagi.
duplicate()ScaleItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informację zwrotną, która jest wyświetlana respondentom podczas odpowiadania na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (nazywany czasem opisem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getLeftLabel()StringPobiera etykietę dolnej granicy skali, jeśli istnieje.
getLowerBound()IntegerPobiera dolną granicę skali.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getRightLabel()StringPobiera etykietę górnej granicy skali, jeśli istnieje.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany przez ItemType.
getUpperBound()IntegerPobiera górną granicę skali.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setBounds(lower, upper)ScaleItemUstawia dolne i górne granice skali.
setGeneralFeedback(feedback)ScaleItemUstawia 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)ScaleItemUstawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setLabels(lower, upper)ScaleItemUstawia etykiety dolnej i górnej granicy skali.
setPoints(points)ScaleItemOkreśla liczbę punktów wartą oceniany element.
setRequired(enabled)ScaleItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ScaleItemOkreś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

NazwaTypOpis
responseIntegerodpowiedź 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()

Pobiera typ elementu reprezentowany przez ItemType.

Powrót

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

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

NazwaTypOpis
lowerIntegernowa dolna granica
upperIntegernowa górna granica

Powrót

ScaleItemScaleItem, ł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

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powrót

ScaleItemScaleItem, ł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

NazwaTypOpis
textStringnowy tekst pomocy

Powrót

ScaleItemScaleItem, ł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

NazwaTypOpis
lowerStringnowa etykieta dolnej granicy
upperStringnowa etykieta górnej granicy

Powrót

ScaleItemScaleItem, ł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

NazwaTypOpis
pointsIntegerliczba punktów warta przedmiot pytania

Powrót

ScaleItemScaleItem, ł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

NazwaTypOpis
enabledBooleanczy 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

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

ScaleItemScaleItem, ł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