Class ParagraphTextValidationBuilder
Stay organized with collections
Save and categorize content based on your preferences.
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);
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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-12-02 UTC.
[null,null,["Last updated 2024-12-02 UTC."],[[["\u003cp\u003e\u003ccode\u003eParagraphTextValidationBuilder\u003c/code\u003e lets you set validation rules for paragraph text responses in Google Forms.\u003c/p\u003e\n"],["\u003cp\u003eYou can enforce rules like minimum/maximum text length, and require or exclude specific patterns in the text.\u003c/p\u003e\n"],["\u003cp\u003eAll validation methods return the \u003ccode\u003eParagraphTextValidationBuilder\u003c/code\u003e object itself, enabling method chaining for concise code.\u003c/p\u003e\n"],["\u003cp\u003eUse this class with \u003ccode\u003eFormApp.createParagraphTextValidation()\u003c/code\u003e to define the validation for a paragraph text item.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the detailed documentation and method table for specifics on each validation rule and its parameters.\u003c/p\u003e\n"]]],[],null,["# Class ParagraphTextValidationBuilder\n\nParagraphTextValidationBuilder\n\nA DataValidationBuilder for a [ParagraphTextValidation](/apps-script/reference/forms/paragraph-text-validation).\n\n```javascript\n// Add a paragraph text item to a form and require the answer to be at least 100\n// characters.\nconst form = FormApp.create('My Form');\nconst paragraphTextItem =\n form.addParagraphTextItem().setTitle('Describe yourself:');\nconst paragraphtextValidation =\n FormApp.createParagraphTextValidation()\n .setHelpText('Answer must be more than 100 characters.')\n .requireTextLengthGreaterThan(100);\nparagraphTextItem.setValidation(paragraphtextValidation);\n``` \n\n### Methods\n\n| Method | Return type | Brief description |\n|--------------------------------------------------------------------------------------------------|-------------------------------------|----------------------------------------------------------------|\n| [requireTextContainsPattern(pattern)](#requireTextContainsPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to contain pattern. |\n| [requireTextDoesNotContainPattern(pattern)](#requireTextDoesNotContainPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to not contain pattern. |\n| [requireTextDoesNotMatchPattern(pattern)](#requireTextDoesNotMatchPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to not match pattern. |\n| [requireTextLengthGreaterThanOrEqualTo(number)](#requireTextLengthGreaterThanOrEqualTo(Integer)) | [ParagraphTextValidationBuilder](#) | Requires response length to be greater than or equal to value. |\n| [requireTextLengthLessThanOrEqualTo(number)](#requireTextLengthLessThanOrEqualTo(Integer)) | [ParagraphTextValidationBuilder](#) | Requires response length to be less than value. |\n| [requireTextMatchesPattern(pattern)](#requireTextMatchesPattern(String)) | [ParagraphTextValidationBuilder](#) | Requires response to match pattern. |\n\nDetailed documentation\n----------------------\n\n### `require``Text``Contains``Pattern(pattern)`\n\nRequires response to contain pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|---------------------------|\n| `pattern` | `String` | text must contain pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Does``Not``Contain``Pattern(pattern)`\n\nRequires response to not contain pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-------------------------------|\n| `pattern` | `String` | text must not contain pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Does``Not``Match``Pattern(pattern)`\n\nRequires response to not match pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-----------------------------|\n| `pattern` | `String` | text must not match pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Length``Greater``Than``Or``Equal``To(number)`\n\nRequires response length to be greater than or equal to value.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|-------------------------------------------------------|\n| `number` | `Integer` | paragraph text length must be greater than this value |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Length``Less``Than``Or``Equal``To(number)`\n\nRequires response length to be less than value.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------|-----------|----------------------------------------------------------------|\n| `number` | `Integer` | paragraph text length must be less than or equal to this value |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining\n\n*** ** * ** ***\n\n### `require``Text``Matches``Pattern(pattern)`\n\nRequires response to match pattern.\n\n#### Parameters\n\n| Name | Type | Description |\n|-----------|----------|-------------------------|\n| `pattern` | `String` | text must match pattern |\n\n#### Return\n\n\n[ParagraphTextValidationBuilder](#) --- this for chaining"]]
