Ta strona została przetłumaczona przez Cloud Translation API.

Class 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

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

Szczegółowa dokumentacja

`createChoice(value)`

Tworzy nową opcję.

Parametry

Nazwa	Typ	Opis
`value`	`String`	wartość 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

Nazwa	Typ	Opis
`value`	`String`	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
`isCorrect`	`Boolean`	czy 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

Nazwa	Typ	Opis
`value`	`String`	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
`navigationItem`	`PageBreakItem`	element, 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.

Parametry

Nazwa	Typ	Opis
`value`	`String`	wartość wyboru, którą respondenci widzą jako etykietę podczas wyświetlania formularza
`navigationType`	`PageNavigationType`	typ 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

Nazwa	Typ	Opis
`response`	`String`	prawidł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

Nazwa	Typ	Opis
`values`	`String[]`	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

Nazwa	Typ	Opis
`choices`	`Choice[]`	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

Nazwa	Typ	Opis
`feedback`	`QuizFeedback`	nowych 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

Nazwa	Typ	Opis
`feedback`	`QuizFeedback`	nowa 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

Nazwa	Typ	Opis
`text`	`String`	nowy 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

Nazwa	Typ	Opis
`points`	`Integer`	liczba 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

Nazwa	Typ	Opis
`enabled`	`Boolean`	czy 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

Nazwa	Typ	Opis
`title`	`String`	nowy 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

Nazwa	Typ	Opis
`enabled`	`Boolean`	`true`, 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