Class CheckboxItem

Pole wyboru

Element pytania, który umożliwia respondentowi zaznaczenie jednego lub kilku pól wyboru, a także opcjonalne pole "other". Elementy są dostępne i można je tworzyć na stronie Form. W przypadku quizu elementy te są automatycznie oceniane.

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
          item.createChoice('Ketchup'),
          item.createChoice('Mustard'),
          item.createChoice('Relish')
    ])
    .showOtherOption(true);

Metody

MetodaZwracany typKrótki opis
clearValidation()CheckboxItemUsuwa wszystkie zatwierdzenia danych tego elementu.
createChoice(value)ChoiceSpowoduje nowy wybór.
createChoice(value, isCorrect)ChoiceSpowoduje nowy wybór.
createResponse(responses)ItemResponseTworzy nowy element: ItemResponse dla tego pola wyboru.
duplicate()CheckboxItemTworzy kopię tego elementu i dołącza ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie odpowiedzi dotyczące elementu.
getFeedbackForCorrect()QuizFeedbackZwraca opinię widoczną dla użytkowników, gdy odpowiedzą poprawnie na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca opinię wyświetlaną osobom, które nieprawidłowo odpowiedzieli na pytanie.
getHelpText()StringPobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator elementu.
getIndex()IntegerPobiera indeks elementu do wszystkich elementów w formularzu.
getPoints()IntegerZwraca wartość punktową elementu możliwego do oceny.
getTitle()StringPobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję "other&quot.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia wybór elementu z tablicy ciągów.
setChoices(choices)CheckboxItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)CheckboxItemOkreśla, jaka opinia ma być widoczna dla użytkowników, gdy prawidłowo odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)CheckboxItemUmożliwiają wyświetlanie odpowiedzi, gdy użytkownik odpowie nieprawidłowo na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)CheckboxItemOkreśla liczbę punktów, które może mieć wartość z możliwością oceny.
setRequired(enabled)CheckboxItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemUstawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).
setValidation(validation)CheckboxItemUstawia weryfikację danych tego elementu.
showOtherOption(enabled)CheckboxItemOkreśla, czy element ma opcję "other&quot.

Szczegółowa dokumentacja

clearValidation()

Usuwa wszystkie zatwierdzenia danych tego elementu.

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createChoice(value)

Spowoduje nowy wybór.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą ankietowani widzą jako etykietę podczas przeglądania formularza;

Zwróć

Choice – nowa opcja

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createChoice(value, isCorrect)

Spowoduje nowy wybór.

Parametry

NazwaTypOpis
valueStringwartość wyboru, którą ankietowani widzą jako etykietę podczas przeglądania formularza;
isCorrectBooleanczy odpowiedź jest prawidłowa

Zwróć

Choice – nowa opcja

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

createResponse(responses)

Tworzy nowy element: ItemResponse dla tego pola wyboru. Argument responses jest tablicą String[] zawierającą wartości, które należy sprawdzić. Zwraca wyjątek, jeśli którakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że showOtherOption(enabled) ma wartość true.

Parametry

NazwaTypOpis
responsesString[]tablica prawidłowych odpowiedzi dla tego pytania jednokrotnego wyboru

Zwróć

ItemResponse – odpowiedź elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.

Zwróć

CheckboxItem – duplikat pytania „CheckboxItem” dotyczący łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getChoices()

Pobiera wszystkie odpowiedzi dotyczące elementu.

Zwróć

Choice[] – szeroki wybór opcji

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getFeedbackForCorrect()

Zwraca opinię widoczną dla użytkowników, gdy odpowiedzą poprawnie na pytanie.

Zwróć

QuizFeedback – opinia (jeśli istnieje).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getFeedbackForIncorrect()

Zwraca opinię wyświetlaną osobom, które nieprawidłowo odpowiedzieli na pytanie.

Zwróć

QuizFeedback – opinia (jeśli istnieje).

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

Pobiera tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Zwróć

String – tekst pomocy lub opis elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

Pobiera unikalny identyfikator elementu.

Zwróć

Integer – identyfikator elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getIndex()

Pobiera indeks elementu do wszystkich elementów w formularzu.

Zwróć

Integer – indeks elementu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPoints()

Zwraca wartość punktową elementu możliwego do oceny.

Zwróć

Integer – liczba punktów przyznawanych za pytanie.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

Pobiera tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Zwróć

String – tytuł lub tekst nagłówka;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

Pobiera typ elementu reprezentowany jako ItemType.

Zwróć

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

hasOtherOption()

Określa, czy element ma opcję "other&quot.

Zwróć

Booleantrue, jeśli element ma opcję "other" jeśli nie, false

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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.

Zwróć

Boolean – czy użytkownik musi odpowiedzieć na pytanie;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setChoiceValues(values)

Ustawia wybór elementu z tablicy ciągów. Zwraca wyjątek, jeśli dana tablica jest pusta.

// 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[]tablica wartości wyboru, które ankietowani widzą jako etykiety podczas przeglądania formularza;

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setChoices(choices)

Ustawia tablicę opcji dla elementu. Zwraca 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

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Narzuty

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

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setFeedbackForCorrect(feedback)

Określa, jaka opinia ma być widoczna dla użytkowników, gdy prawidłowo odpowiedzą 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
feedbackQuizFeedbacknową opinię. Wartość null spowoduje usunięcie opinii.

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setFeedbackForIncorrect(feedback)

Umożliwiają wyświetlanie odpowiedzi, gdy użytkownik odpowie nieprawidłowo na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

Ustawia tekst pomocy elementu (czasem nazywany tekstem opisu dla elementów układu takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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że mieć wartość z możliwością oceny. Domyślnie nowe elementy mają wartość 0.

Parametry

NazwaTypOpis
pointsIntegerliczbę punktów przyznawanych za pytanie

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego 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

NazwaTypOpis
enabledBooleanczy użytkownik musi odpowiedzieć na pytanie;

Zwróć

CheckboxItem – bieżący element (łańcuch)

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

Ustawia tytuł elementu (czasem nazywany tekstem nagłówka, w przypadku SectionHeaderItem).

Parametry

NazwaTypOpis
titleStringnowego tytułu lub tekstu nagłówka,

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setValidation(validation)

Ustawia weryfikację danych tego elementu. Przekazywanie wartości null lub weryfikacji, która nie wymaga żadnych funkcji, spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationCheckboxValidationznacznika wyboru, aby zastosować go do tego elementu.

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

showOtherOption(enabled)

Określa, czy element ma opcję "other&quot. Wartością domyślną w nowych CheckboxItem lub MultipleChoiceItem jest false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli element ma opcję &&;quot; inny; false, jeśli nie

Zwróć

CheckboxItem – ten CheckboxItem do łańcucha

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji przy użyciu co najmniej jednego z tych zakresów:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms