Class CheckboxItem

Pole wyboruElement

Element pytania, który umożliwia respondentowi zaznaczenie co najmniej jednego pola wyboru, a także opcjonalne pole „inne”. Elementy można tworzyć i otwierać w ramach Form. Gdy są używane w teście, są automatycznie oceniane. 

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 sprawdzanie poprawności danych dla tego elementu pola wyboru.
createChoice(value)ChoiceTworzy nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy nowy wybór.
createResponse(responses)ItemResponseTworzy nowy element ItemResponse dla tego elementu z polem wyboru.
duplicate()CheckboxItemTworzy kopię tego elementu i dodaje ją na końcu formularza.
getChoices()Choice[]Pobiera wszystkie opcje dotyczące danego elementu.
getFeedbackForCorrect()QuizFeedbackZwraca opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie.
getFeedbackForIncorrect()QuizFeedbackZwraca opinię, która jest wyświetlana respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
getId()IntegerPobiera unikalny identyfikator produktu.
getIndex()IntegerPobiera indeks elementu spośród wszystkich elementów w formularzu.
getPoints()IntegerZwraca liczbę punktów za element, który można ocenić.
getTitle()StringPobiera tytuł elementu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
getType()ItemTypePobiera typ elementu jako ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję „Inne”.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia opcje elementu na podstawie tablicy ciągów znaków.
setChoices(choices)CheckboxItemOkreśla tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)CheckboxItemOkreśla opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi na pytanie.
setFeedbackForIncorrect(feedback)CheckboxItemOkreśla komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)CheckboxItemOkreśla liczbę punktów, które można przyznać ocenianemu elementowi.
setRequired(enabled)CheckboxItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemUstawia tytuł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).
setValidation(validation)CheckboxItemUstawia sprawdzanie poprawności danych dla tego elementu pola wyboru.
showOtherOption(enabled)CheckboxItemOkreśla, czy element ma opcję „Inne”.

Szczegółowa dokumentacja

clearValidation()

Usuwa sprawdzanie poprawności danych dla tego elementu pola wyboru.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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)

Tworzy nowy wybór.

Parametry

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

Powrót

Choice – nowy wybór

Autoryzacja

Skrypty, które korzystają 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 nowy wybór.

Parametry

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

Powrót

Choice – nowy wybór

Autoryzacja

Skrypty, które korzystają 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(responses)

Tworzy nowy element ItemResponse dla tego elementu z polem wyboru. Argument responses to tablica String[] zawierająca wartości, które należy sprawdzić. Wyjątek jest zgłaszany, jeśli jakakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że showOtherOption(enabled) ma wartość true.

Parametry

NazwaTypOpis
responsesString[]tablica prawidłowych odpowiedzi na to pytanie jednokrotnego wyboru.

Powrót

ItemResponse – odpowiedź na element

Autoryzacja

Skrypty, które korzystają 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 dodaje ją na końcu formularza.

Powrót

CheckboxItem – duplikat tego elementu CheckboxItem, służący do łańcuchowania.

Autoryzacja

Skrypty, które korzystają 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 danego elementu.

Powrót

Choice[] – tablica opcji

Autoryzacja

Skrypty, które korzystają 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 opinię, która jest wyświetlana respondentom po udzieleniu przez nich prawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback – opinia (jeśli została przesłana).

Autoryzacja

Skrypty, które korzystają 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 opinię, która jest wyświetlana respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback – opinia (jeśli została przesłana).

Autoryzacja

Skrypty, które korzystają 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 elementu (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub tekst opisu produktu,

Autoryzacja

Skrypty, które korzystają 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 produktu.

Powrót

Integer – identyfikator produktu

Autoryzacja

Skrypty, które korzystają 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, które korzystają 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 liczbę punktów za element, który można ocenić.

Powrót

Integer – liczba punktów, jaką można uzyskać za pytanie.

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Powrót

String – tytuł lub tekst nagłówka

Autoryzacja

Skrypty, które korzystają 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 jako ItemType.

Powrót

ItemType – typ elementu

Autoryzacja

Skrypty, które korzystają 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 opcję „Inne”.

Powrót

Boolean – true, jeśli produkt ma opcję „inne”; false, jeśli nie

Autoryzacja

Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie

Autoryzacja

Skrypty, które korzystają 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. Wyjątek, jeśli podany tablica jest pusta. 

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

Parametry

NazwaTypOpis
valuesString[]tablica wartości opcji, które respondenci widzą jako etykiety podczas wyświetlania formularza.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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)

Określa tablicę opcji dla elementu. Wyjątek jest zgłaszany, jeśli podana tablica jest pusta lub zawiera element null. 

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

Parametry

NazwaTypOpis
choicesChoice[]wiele opcji

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Rzuty

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

Autoryzacja

Skrypty, które korzystają 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)

Określa opinię, która ma być wyświetlana respondentom, gdy udzielą prawidłowej odpowiedzi na pytanie. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 komentarz, który ma być wyświetlany respondentom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowe opinie

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 (czasami nazywany tekstem opisu dla elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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, które można przyznać ocenianemu elementowi. Wartość domyślna dla nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów za pytanie

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 respondent musi odpowiedzieć na pytanie.

Parametry

NazwaTypOpis
enabledBooleanczy respondent musi udzielić odpowiedzi na pytanie.

Powrót

CheckboxItem – bieżący element (do łańcuchowania).

Autoryzacja

Skrypty, które korzystają 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ł produktu (czasami nazywany tekstem nagłówka w przypadku SectionHeaderItem).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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

setValidation(validation)

Ustawia sprawdzanie poprawności danych dla tego elementu pola wyboru. Przekazanie wartości null lub walidacji bez wywołania funkcji require spowoduje usunięcie wcześniejszej walidacji.

Parametry

NazwaTypOpis
validationCheckboxValidationpole wyboru, które pozwala zastosować tę funkcję do tego produktu.

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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 opcję „Inne”. Wartość domyślna dla nowego typu CheckboxItem lub MultipleChoiceItem to false.

Parametry

NazwaTypOpis
enabledBooleantrue, jeśli produkt ma opcję „inne”; false, jeśli nie

Powrót

CheckboxItem – ta CheckboxItem, aby utworzyć łańcuch

Autoryzacja

Skrypty, które korzystają 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