Class DateTimeItem

DateTimeItem

Элемент вопроса, позволяющий респонденту указать дату и время. К элементам можно получить доступ или создать их из Form . При использовании в викторине эти элементы оцениваются.

// Open a form by ID and add a new date-time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateTimeItem();
item.setTitle('When do you want to meet?');

Методы

Метод Тип возврата Краткое описание
createResponse(response) ItemResponse Создает новый ItemResponse для этого элемента даты и времени.
duplicate() DateTimeItem Создает копию этого элемента и добавляет ее в конец формы.
getGeneralFeedback() QuizFeedback Возвращает отзыв, который отображается респондентам, когда они отвечают на оцениваемый вопрос.
getHelpText() String Получает текст справки по элементу (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).
getId() Integer Получает уникальный идентификатор элемента.
getIndex() Integer Получает индекс элемента среди всех элементов формы.
getPoints() Integer Возвращает количество баллов оцениваемого элемента.
getTitle() String Получает заголовок элемента (иногда называемый текстом заголовка, в случае с SectionHeaderItem ).
getType() ItemType Получает тип элемента, представленный как ItemType .
includesYear() Boolean Определяет, включает ли элемент даты параметр года.
isRequired() Boolean Определяет, должен ли респондент отвечать на вопрос.
setGeneralFeedback(feedback) DateTimeItem Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).
setHelpText(text) DateTimeItem Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).
setIncludesYear(enableYear) DateTimeItem Определяет, включает ли элемент даты настройку года.
setPoints(points) DateTimeItem Устанавливает количество баллов, которое дает оцениваемый предмет.
setRequired(enabled) DateTimeItem Устанавливает, должен ли респондент отвечать на вопрос.
setTitle(title) DateTimeItem Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).

Подробная документация

createResponse(response)

Создает новый ItemResponse для этого элемента даты и времени. Поле секунд объекта Date игнорируется; по умолчанию используются поля года, месяца, дня, часа и минуты. Если setIncludesYear(enabled) установлено значение false , год также игнорируется.

Параметры

Имя Тип Описание
response Date объект Date , представляющий месяц, день, час, минуту и, возможно, год

Возвращаться

ItemResponse — ответ элемента

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

duplicate()

Создает копию этого элемента и добавляет ее в конец формы.

Возвращаться

DateTimeItem — дубликат этого DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

  • 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()

Получает тип элемента, представленный как ItemType .

Возвращаться

ItemType — тип элемента

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

includesYear()

Определяет, включает ли элемент даты параметр года.

Возвращаться

Booleantrue , если дата включает настройку года; false если нет

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

isRequired()

Определяет, должен ли респондент отвечать на вопрос.

Возвращаться

Boolean — должен ли респондент отвечать на вопрос

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setGeneralFeedback(feedback)

Устанавливает обратную связь, которая будет отображаться респондентам, когда они отвечают на оцениваемый вопрос, на который нет правильного или неправильного ответа (т. е. вопросы, требующие оценки вручную).

Параметры

Имя Тип Описание
feedback QuizFeedback новый отзыв

Возвращаться

DateTimeItem — этот DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setHelpText(text)

Устанавливает текст справки для элемента (иногда называемый текстом описания для таких элементов макета, как ImageItems , PageBreakItems SectionHeaderItems ).

Параметры

Имя Тип Описание
text String новый текст справки

Возвращаться

DateTimeItem — этот DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setIncludesYear(enableYear)

Определяет, включает ли элемент даты настройку года. По умолчанию для новых элементов даты установлено значение true .

Параметры

Имя Тип Описание
enableYear Boolean true , если дата включает настройку года; false если нет

Возвращаться

DateTimeItem — этот DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setPoints(points)

Устанавливает количество баллов, которое дает оцениваемый предмет. По умолчанию для новых элементов установлено значение 0.

Параметры

Имя Тип Описание
points Integer количество баллов, которое приносит вопрос

Возвращаться

DateTimeItem — этот DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setRequired(enabled)

Устанавливает, должен ли респондент отвечать на вопрос.

Параметры

Имя Тип Описание
enabled Boolean должен ли респондент отвечать на вопрос

Возвращаться

DateTimeItem — текущий элемент (для цепочки)

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setTitle(title)

Устанавливает заголовок элемента (иногда называемый текстом заголовка, в случае SectionHeaderItem ).

Параметры

Имя Тип Описание
title String новый заголовок или текст заголовка

Возвращаться

DateTimeItem — этот DateTimeItem для цепочки

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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