Class MultipleChoiceItem

MultipleChoiceItem

Element pytania, który umożliwia respondentowi wybranie jednej odpowiedzi z listy przycisków, lub opcjonalne pole „inne” . Elementy można otwierać i tworzyć na koncie Form. Zastosowanie są oceniane automatycznie. 

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

Metody

MetodaZwracany typKrótki opis
createChoice(value)ChoiceTworzy nową opcję.
createChoice(value, isCorrect)ChoiceTworzy nową opcję.
createChoice(value, navigationItem)ChoiceSłuży do utworzenia nowej opcji z opcją nawigacji po stronie, która powoduje przejście do danego elementu podziału strony.
createChoice(value, navigationType)ChoiceSłuży do tworzenia nowej opcji z opcją nawigacji na stronie.
createResponse(response)ItemResponseTworzy nowy obiekt ItemResponse dla tego elementu jednokrotnego wyboru.
duplicate()MultipleChoiceItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.
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.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem nazywany tekstem nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany przez ItemType.
hasOtherOption()BooleanOkreśla, czy element ma atrybut „inne” .
isRequired()BooleanOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setChoiceValues(values)MultipleChoiceItemUstawia opcje elementu na podstawie tablicy ciągów znaków.
setChoices(choices)MultipleChoiceItemUstawia tablicę opcji elementu.
setFeedbackForCorrect(feedback)MultipleChoiceItemUstawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie.
setFeedbackForIncorrect(feedback)MultipleChoiceItemOkreśla, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.
setHelpText(text)MultipleChoiceItemUstawia tekst pomocy elementu (nazywany czasem opisu tekstem w przypadku elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)MultipleChoiceItemOkreśla liczbę punktów wartą oceniany element.
setRequired(enabled)MultipleChoiceItemOkreśla, czy użytkownik musi odpowiedzieć na pytanie.
setTitle(title)MultipleChoiceItemOkreśla tytuł elementu (w przypadku SectionHeaderItem nazywany też tekstem nagłówka).
showOtherOption(enabled)MultipleChoiceItemOkreśla, czy element ma atrybut „inne” .

Szczegółowa dokumentacja

createChoice(value)

Tworzy nową opcję.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza

Powrót

Choice – nowa opcja

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

createChoice(value, isCorrect)

Tworzy nową opcję.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
isCorrectBooleanczy wybrana odpowiedź jest poprawna

Powrót

Choice – nowa opcja

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

createChoice(value, navigationItem)

Służy do utworzenia nowej opcji z opcją nawigacji po stronie, która powoduje przejście do danego elementu podziału strony. Ten jest odpowiednikiem funkcji createChoice(value, navigationType) z wartością navigationType ustawioną na FormApp.PageNavigationType.GO_TO_PAGE. Opcje, które używają strony elementów nawigacyjnych nie można łączyć w tym samym elemencie z opcjami, które nie używają nawigacji na stronie.

Nawigacja po stronie następuje po zakończeniu przez respondenta strony, która zawiera tę opcję. i tylko wtedy, gdy respondent wybrał tę opcję. Jeśli respondent wybrał wiele opcji z na danej stronie, działa tylko ostatnia opcja nawigacji. Nawigacja po stronach nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
navigationItemPageBreakItemelement, do którego chcesz przejść

Powrót

Choice – nowa opcja

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

createChoice(value, navigationType)

Służy do tworzenia nowej opcji z opcją nawigacji na stronie. Opcje, które używają nawigacji na stronie, nie mogą być połączony w tym samym elemencie z opcjami, które nie używają nawigacji na stronie.

Nawigacja po stronie następuje po zakończeniu przez respondenta strony, która zawiera tę opcję. i tylko wtedy, gdy respondent wybrał tę opcję. Jeśli respondent wybrał wiele opcji z na danej stronie, działa tylko ostatnia opcja nawigacji. Nawigacja po stronach nie ma też wpływu na ostatnią stronę formularza.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
navigationTypePageNavigationTypetyp nawigacji wyboru

Powrót

Choice – nowa opcja

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

createResponse(response)

Tworzy nowy obiekt ItemResponse dla tego elementu jednokrotnego wyboru. Zgłasza wyjątek, jeśli Argument response nie pasuje do poprawnej opcji dla tego elementu, chyba że showOtherOption(enabled) ma wartość true.

Parametry

NazwaTypOpis
responseStringprawidłową odpowiedź na ten element jednokrotnego wyboru

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

MultipleChoiceItem – duplikat kodu MultipleChoiceItem, 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

getChoices()

Pobiera wszystkie opcje dotyczące elementu.

Powrót

Choice[] – tablica opcji

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

getFeedbackForCorrect()

Zwraca informację zwrotną, która wyświetla się użytkownikom, gdy udzielili prawidłowej odpowiedzi na pytanie.

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

getFeedbackForIncorrect()

Zwraca informację zwrotną, która jest wyświetlana użytkownikom, którzy odpowiedzieli nieprawidłowo na pytanie.

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

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

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

hasOtherOption()

Określa, czy element ma atrybut „inne” .

Powrót

Boolean – true, jeśli element ma wartość „inny” opcja; false, jeśli nie

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

setChoiceValues(values)

Ustawia opcje elementu na podstawie tablicy ciągów znaków. Zgłasza wyjątek, jeśli dana tablica jest puste. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parametry

NazwaTypOpis
valuesString[]tablicę wartości wyboru, którą respondenci widzą jako etykiety podczas przeglądania formularza

Powrót

MultipleChoiceItem – MultipleChoiceItem, ł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

setChoices(choices)

Ustawia tablicę opcji elementu. Zgłasza wyjątek, jeśli dana tablica jest pusta lub zawiera element null. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

Parametry

NazwaTypOpis
choicesChoice[]szeroki wybór

Powrót

MultipleChoiceItem – MultipleChoiceItem, łańcuch

Rzuty

Error – jeśli dana tablica jest null, pusta lub zawiera element null,

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

setFeedbackForCorrect(feedback)

Ustawia informację, że odpowiedzi będą wyświetlane użytkownikom, gdy odpowiedzą prawidłowo na pytanie. 

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowych opinii. Wartość null usuwa informację zwrotną.

Powrót

MultipleChoiceItem – MultipleChoiceItem, ł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

setFeedbackForIncorrect(feedback)

Określa, że odpowiedź na pytanie jest wyświetlana użytkownikom, którzy odpowiedzą nieprawidłowo na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Powrót

MultipleChoiceItem – MultipleChoiceItem, ł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

MultipleChoiceItem – MultipleChoiceItem, ł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

MultipleChoiceItem – MultipleChoiceItem, ł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

MultipleChoiceItem – 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

MultipleChoiceItem – MultipleChoiceItem, ł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

showOtherOption(enabled)

Określa, czy element ma atrybut „inne” . Ustawienie domyślne dla nowego modelu CheckboxItem lub MultipleChoiceItem – false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli element ma wartość „inne” opcja; false, jeśli nie

Powrót

MultipleChoiceItem – MultipleChoiceItem, ł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