Элемент вопроса, позволяющий респонденту ввести одну строку текста. К элементам можно получить доступ или создать их из Form
. При использовании в викторине эти элементы оцениваются.
// Open a form by ID and add a new text item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addTextItem(); item.setTitle('What is your name?');
Методы
Метод | Тип возврата | Краткое описание |
---|---|---|
clearValidation() | TextItem | Удаляет любую проверку данных для этого текстового элемента. |
createResponse(response) | ItemResponse | Создает новый ItemResponse для этого текстового элемента. |
duplicate() | TextItem | Создает копию этого элемента и добавляет ее в конец формы. |
getGeneralFeedback() | QuizFeedback | Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос. |
getHelpText() | String | Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ). |
getId() | Integer | Получает уникальный идентификатор элемента. |
getIndex() | Integer | Получает индекс элемента среди всех элементов формы. |
getPoints() | Integer | Возвращает количество баллов оцениваемого элемента. |
getTitle() | String | Получает заголовок элемента (иногда называемый текстом заголовка, в случае с SectionHeaderItem ). |
getType() | ItemType | Получает тип элемента, представленный как ItemType . |
isRequired() | Boolean | Определяет, должен ли респондент отвечать на вопрос. |
setGeneralFeedback(feedback) | TextItem | Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную). |
setHelpText(text) | TextItem | Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ). |
setPoints(points) | TextItem | Устанавливает количество баллов, которое дает оцениваемый предмет. |
setRequired(enabled) | TextItem | Устанавливает, должен ли респондент отвечать на вопрос. |
setTitle(title) | TextItem | Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ). |
setValidation(validation) | TextItem | Устанавливает проверку данных для этого текстового элемента. |
Подробная документация
clearValidation()
Удаляет любую проверку данных для этого текстового элемента.
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(response)
Создает новый ItemResponse
для этого текстового элемента.
Параметры
Имя | Тип | Описание |
---|---|---|
response | String | ответ на вопрос, заданный в статье |
Возвращаться
ItemResponse
— ответ элемента
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
Создает копию этого элемента и добавляет ее в конец формы.
Возвращаться
TextItem
— дубликат этого TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGeneralFeedback()
Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос.
Возвращаться
QuizFeedback
— обратная связь, если она есть.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как ImageItems
, PageBreakItems
SectionHeaderItems
).
Возвращаться
String
— текст справки или текст описания элемента.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Получает уникальный идентификатор элемента.
Возвращаться
Integer
— идентификатор предмета
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Получает индекс элемента среди всех элементов формы.
Возвращаться
Integer
— индекс элемента
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getPoints()
Возвращает количество баллов оцениваемого элемента.
Возвращаться
Integer
— количество баллов, которое приносит вопрос.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Получает заголовок элемента (иногда называемый текстом заголовка, в случае с SectionHeaderItem
).
Возвращаться
String
— заголовок или текст заголовка элемента.
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
isRequired()
Определяет, должен ли респондент отвечать на вопрос.
Возвращаться
Boolean
— должен ли респондент отвечать на вопрос
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
Параметры
Имя | Тип | Описание |
---|---|---|
feedback | QuizFeedback | новый отзыв |
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems
, PageBreakItems
SectionHeaderItems
).
Параметры
Имя | Тип | Описание |
---|---|---|
text | String | новый текст справки |
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
Устанавливает количество баллов, которое дает оцениваемый предмет. По умолчанию для новых элементов установлено значение 0.
Параметры
Имя | Тип | Описание |
---|---|---|
points | Integer | количество баллов, которое приносит вопрос |
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
Устанавливает, должен ли респондент отвечать на вопрос.
Параметры
Имя | Тип | Описание |
---|---|---|
enabled | Boolean | должен ли респондент отвечать на вопрос |
Возвращаться
TextItem
— текущий элемент (для цепочки)
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem
).
Параметры
Имя | Тип | Описание |
---|---|---|
title | String | новый заголовок или текст заголовка |
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
Устанавливает проверку данных для этого текстового элемента. Передача значения null или проверки без вызова требуемых функций приведет к удалению любой предыдущей проверки.
Параметры
Имя | Тип | Описание |
---|---|---|
validation | TextValidation | TextValidation для применения к этому элементу. |
Возвращаться
TextItem
— этот TextItem
для цепочки
Авторизация
Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms