Class CheckboxValidation

  • CheckboxValidation is used to set validation rules specifically for checkbox items within Google Forms.

  • It allows you to define requirements like the number of choices a user must select using methods like requireSelectExactly().

  • A help text can be associated with the validation to guide the user using setHelpText().

CheckboxValidation

A DataValidation for a CheckboxItem.

// Add a checkBox item to a form and require exactly two selections.
const form = FormApp.create('My Form');
const checkBoxItem = form.addCheckboxItem();
checkBoxItem.setTitle('What two condiments would you like on your hot dog?');
checkBoxItem.setChoices([
  checkBoxItem.createChoice('Ketchup'),
  checkBoxItem.createChoice('Mustard'),
  checkBoxItem.createChoice('Relish'),
]);
const checkBoxValidation = FormApp.createCheckboxValidation()
                               .setHelpText('Select two condiments.')
                               .requireSelectExactly(2)
                               .build();
checkBoxItem.setValidation(checkBoxValidation);