Class ParagraphTextValidationBuilder

AI-generated Key Takeaways

• ParagraphTextValidationBuilder lets you set validation rules for paragraph text responses in Google Forms.

• You can enforce rules like minimum/maximum text length, and require or exclude specific patterns in the text.

• All validation methods return the ParagraphTextValidationBuilder object itself, enabling method chaining for concise code.

• Use this class with FormApp.createParagraphTextValidation() to define the validation for a paragraph text item.

• Refer to the detailed documentation and method table for specifics on each validation rule and its parameters.

ParagraphTextValidationBuilder

A DataValidationBuilder for a ParagraphTextValidation.

// Add a paragraph text item to a form and require the answer to be at least 100
// characters.
const form = FormApp.create('My Form');
const paragraphTextItem =
    form.addParagraphTextItem().setTitle('Describe yourself:');
const paragraphtextValidation =
    FormApp.createParagraphTextValidation()
        .setHelpText('Answer must be more than 100 characters.')
        .requireTextLengthGreaterThan(100);
paragraphTextItem.setValidation(paragraphtextValidation);

Methods

Method	Return type	Brief description
requireTextContainsPattern(pattern)	ParagraphTextValidationBuilder	Requires response to contain pattern.
requireTextDoesNotContainPattern(pattern)	ParagraphTextValidationBuilder	Requires response to not contain pattern.
requireTextDoesNotMatchPattern(pattern)	ParagraphTextValidationBuilder	Requires response to not match pattern.
requireTextLengthGreaterThanOrEqualTo(number)	ParagraphTextValidationBuilder	Requires response length to be greater than or equal to value.
requireTextLengthLessThanOrEqualTo(number)	ParagraphTextValidationBuilder	Requires response length to be less than value.
requireTextMatchesPattern(pattern)	ParagraphTextValidationBuilder	Requires response to match pattern.

Detailed documentation

requireTextContainsPattern(pattern)

Requires response to contain pattern.

Parameters

Name	Type	Description
pattern	String	text must contain pattern

Return

ParagraphTextValidationBuilder — this for chaining

---

requireTextDoesNotContainPattern(pattern)

Requires response to not contain pattern.

Parameters

Name	Type	Description
pattern	String	text must not contain pattern

Return

ParagraphTextValidationBuilder — this for chaining

---

requireTextDoesNotMatchPattern(pattern)

Requires response to not match pattern.

Parameters

Name	Type	Description
pattern	String	text must not match pattern

Return

ParagraphTextValidationBuilder — this for chaining

---

requireTextLengthGreaterThanOrEqualTo(number)

Requires response length to be greater than or equal to value.

Parameters

Name	Type	Description
number	Integer	paragraph text length must be greater than this value

Return

ParagraphTextValidationBuilder — this for chaining

---

requireTextLengthLessThanOrEqualTo(number)

Requires response length to be less than value.

Parameters

Name	Type	Description
number	Integer	paragraph text length must be less than or equal to this value

Return

ParagraphTextValidationBuilder — this for chaining

---

requireTextMatchesPattern(pattern)

Requires response to match pattern.

Parameters

Name	Type	Description
pattern	String	text must match pattern

Return

ParagraphTextValidationBuilder — this for chaining