Class ScaleItem

ScaleItem

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

MetodaZwracany typKrótki opis
createResponse(response)ItemResponseTworzy nowy element (ItemResponse) dla tego elementu wagi.
duplicate()ScaleItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getGeneralFeedback()QuizFeedbackZwraca informacje wyświetlane użytkownikom, gdy odpowiadają na pytanie, które można ocenić.
getHelpText()StringPobiera tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu 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 formularza.
getLeftLabel()StringPobiera etykietę dolnej granicy skali (jeśli istnieje).
getLowerBound()IntegerPobiera dolną granicę wagi.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getRightLabel()StringPobiera etykietę górnej granicy skali (jeśli istnieje).
getTitle()StringPobiera tytuł elementu (w przypadku elementu SectionHeaderItem jest czasami nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu, reprezentowany jako ItemType.
getUpperBound()IntegerPobiera górną granicę wagi.
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setBounds(lower, upper)ScaleItemOkreśla dolną i górną granicę skali.
setGeneralFeedback(feedback)ScaleItemOkreś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)ScaleItemUstawia tekst pomocy dotyczącej elementu (czasami nazywany tekstem opisu 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 za element, który można ocenić.
setRequired(enabled)ScaleItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)ScaleItemUstawia 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

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

Pobiera typ elementu, reprezentowany jako ItemType.

Powroty

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

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

NazwaTypOpis
lowerIntegernowa dolna granica
upperIntegernowa 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

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

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

NazwaTypOpis
lowerStringnowa etykieta dolnej granicy
upperStringnową 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

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

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

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