Class CheckboxItem

Pole wyboruElement

Pytanie, w którym respondent może zaznaczyć co najmniej jedno pole wyboru, a także opcjonalne pole „Inne”. Dostęp do elementów można uzyskać lub tworzyć je z poziomu Form. W przypadku użycia w quizie te elementy są oceniane automatycznie. 

// 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 w przypadku tego pola wyboru.
createChoice(value)ChoiceTworzy nowy wybór.
createChoice(value, isCorrect)ChoiceTworzy 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 opcje elementu.
getFeedbackForCorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
getFeedbackForIncorrect()QuizFeedback|nullZwraca opinię, która jest wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
getHelpText()StringPobiera tekst pomocy 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 wśród wszystkich elementów w formularzu.
getPoints()IntegerZwraca wartość punktową elementu podlegającego ocenie.
getTitle()StringPobiera tytuł elementu (w przypadku SectionHeaderItem jest to czasami tekst nagłówka).
getType()ItemTypePobiera typ elementu reprezentowany jako ItemType.
hasOtherOption()BooleanOkreśla, czy element ma opcję „Inne”.
isRequired()BooleanOkreśla, czy respondent musi odpowiedzieć na pytanie.
setChoiceValues(values)CheckboxItemUstawia wybory dla elementu z tablicy ciągów znaków.
setChoices(choices)CheckboxItemUstawia tablicę opcji dla elementu.
setFeedbackForCorrect(feedback)CheckboxItemUstawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą na pytanie.
setFeedbackForIncorrect(feedback)CheckboxItemUstawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.
setHelpText(text)CheckboxItemUstawia tekst pomocy dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).
setPoints(points)CheckboxItemUstawia liczbę punktów, jaką jest warta oceniana pozycja.
setRequired(enabled)CheckboxItemOkreśla, czy respondent musi odpowiedzieć na pytanie.
setTitle(title)CheckboxItemUstawia tytuł elementu (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).
setValidation(validation)CheckboxItemUstawia sprawdzanie poprawności danych dla tego elementu pola wyboru.
showOtherOption(enabled)CheckboxItemOkreśla, czy element ma opcję „Inna odpowiedź”.

Szczegółowa dokumentacja

clearValidation()

Usuwa sprawdzanie poprawności danych w przypadku tego pola wyboru.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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óra jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;

Powrót

Choice – nowy wybór

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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óra jest wyświetlana respondentom jako etykieta podczas przeglądania formularza;
isCorrectBooleanczy wybrana odpowiedź jest prawidłowa;

Powrót

Choice – nowy wybór

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 to tablica String[] zawierająca wartości, które należy sprawdzić. Zgłasza wyjątek, jeśli jakakolwiek wartość nie pasuje do prawidłowego wyboru dla tego elementu, chyba że parametr showOtherOption(enabled) jest ustawiony na true.

Parametry

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

Powrót

ItemResponse – odpowiedź dotycząca elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

CheckboxItem – duplikat tego CheckboxItem do łączenia

Autoryzacja

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

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

getChoices()

Pobiera wszystkie opcje elementu.

Powrót

Choice[] – tablica opcji

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użytkownikom, gdy poprawnie odpowiedzą na pytanie.

Powrót

QuizFeedback|null – opinia, jeśli została dodana.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Powrót

QuizFeedback|null – opinia, jeśli została dodana.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Powrót

String – tekst pomocy lub opis elementu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Integer – identyfikator produktu;

Autoryzacja

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

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

getIndex()

Pobiera indeks elementu wśród wszystkich elementów w formularzu.

Powrót

Integer – indeks elementu;

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 podlegającego ocenie.

Powrót

Integer – liczba punktów za pytanie.

Autoryzacja

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

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

getTitle()

Pobiera tytuł elementu (w przypadku SectionHeaderItem jest to czasami tekst nagłówka).

Powrót

String – tytuł lub tekst nagłówka produktu.

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

ItemType – typ produktu

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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ę „Inne”.

Powrót

Boolean – true, jeśli element ma opcję „Inne”; false, jeśli nie

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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.

Powrót

Boolean – czy respondent musi odpowiedzieć na pytanie;

Autoryzacja

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

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

setChoiceValues(values)

Ustawia wybory dla elementu z tablicy ciągów znaków. Zwraca wyjątek, jeśli podana 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 do wyboru, które respondenci widzą jako etykiety podczas wyświetlania formularza;

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 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[]tablicę opcji,

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Zgłasza

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

Autoryzacja

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

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

setFeedbackForCorrect(feedback)

Ustawia informację zwrotną, która ma być wyświetlana użytkownikom, gdy poprawnie odpowiedzą 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
feedbackQuizFeedbacknowe opinie. Wartość null spowoduje usunięcie opinii.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

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

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

setFeedbackForIncorrect(feedback)

Ustawia opinię, która ma być wyświetlana użytkownikom, gdy udzielą nieprawidłowej odpowiedzi na pytanie.

Parametry

NazwaTypOpis
feedbackQuizFeedbacknowa opinia.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 dotyczący elementu (czasami nazywany tekstem opisu w przypadku elementów układu, takich jak ImageItems, PageBreakItems i SectionHeaderItems).

Parametry

NazwaTypOpis
textStringnowy tekst pomocy,

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

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

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

setPoints(points)

Ustawia liczbę punktów, jaką jest warta oceniana pozycja. Wartość domyślna dla nowych elementów to 0.

Parametry

NazwaTypOpis
pointsIntegerliczba punktów, jaką można uzyskać za pytanie.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 respondent musi odpowiedzieć na pytanie;

Powrót

CheckboxItem – bieżący element (do łączenia);

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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 (w przypadku SectionHeaderItem czasami nazywany tekstem nagłówka).

Parametry

NazwaTypOpis
titleStringnowy tytuł lub tekst nagłówka;

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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 weryfikacji bez wywołania funkcji require spowoduje usunięcie wcześniejszej weryfikacji.

Parametry

NazwaTypOpis
validationCheckboxValidationobiekt CheckboxValidation, który ma zostać zastosowany do tego elementu.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem 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ę „Inna odpowiedź”. Domyślna wartość nowego elementu CheckboxItem lub MultipleChoiceItem to false.

Parametry

NazwaTypOpis
enabledBooleantrue jeśli element ma opcję „Inne”; false w przeciwnym razie.

Powrót

CheckboxItem – ten CheckboxItem, do tworzenia łańcuszków

Autoryzacja

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

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