Class DateItem

DataItem

Um item de pergunta que permite ao respondente indicar uma data. Os itens podem ser acessados ou criados em um Form. Quando usados em um teste, esses itens são avaliados.

// Open a form by ID and add a new date item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addDateItem();
item.setTitle('When were you born?');

Métodos

Método	Tipo de retorno	Breve descrição
createResponse(response)	ItemResponse	Cria um novo ItemResponse para este item de data.
duplicate()	DateItem	Cria uma cópia do item e a anexa ao final do formulário.
getGeneralFeedback()	QuizFeedback	Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota.
getHelpText()	String	Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).
getId()	Integer	Recebe o identificador exclusivo do item.
getIndex()	Integer	Consegue o índice do item entre todos os itens no formulário.
getPoints()	Integer	Retorna o valor em pontos de um item que pode ser avaliado.
getTitle()	String	Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
getType()	ItemType	Recebe o tipo do item, representado como um ItemType.
includesYear()	Boolean	Determina se o item de data inclui uma opção de ano.
isRequired()	Boolean	Determina se o participante precisa responder à pergunta.
setGeneralFeedback(feedback)	DateItem	Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta que não tem uma resposta correta ou incorreta (ou seja, perguntas que exigem avaliação manual).
setHelpText(text)	DateItem	Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).
setIncludesYear(enableYear)	DateItem	Define se o item de data inclui uma configuração de ano.
setPoints(points)	DateItem	Define o número de pontos de um item que pode ser avaliado.
setRequired(enabled)	DateItem	Define se o respondente precisa responder à pergunta.
setTitle(title)	DateItem	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Documentação detalhada

createResponse(response)

Cria um novo ItemResponse para este item de data. Os campos de hora do objeto Date são ignorados. Por padrão, apenas os campos de ano, mês e dia são usados. Se setIncludesYear(enabled) estiver definido como false, o ano também será ignorado.

Parâmetros

Nome	Tipo	Descrição
response	Date	um objeto Date que representa um mês, um dia e, possivelmente, um ano

Retornar

ItemResponse: a resposta do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

duplicate()

Cria uma cópia do item e a anexa ao final do formulário.

Retornar

DateItem: uma cópia desta DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getGeneralFeedback()

Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota.

Retornar

QuizFeedback: o feedback, se houver.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getHelpText()

Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).

Retornar

String: o texto de ajuda ou de descrição do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getId()

Recebe o identificador exclusivo do item.

Retornar

Integer: o ID do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getIndex()

Consegue o índice do item entre todos os itens no formulário.

Retornar

Integer: o índice do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getPoints()

Retorna o valor em pontos de um item que pode ser avaliado.

Retornar

Integer: o número de pontos que uma pergunta vale.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getTitle()

Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Retornar

String: o título ou o texto do cabeçalho do item.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

getType()

Recebe o tipo do item, representado como um ItemType.

Retornar

ItemType: o tipo do item

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

includesYear()

Determina se o item de data inclui uma opção de ano.

Retornar

Boolean: true se a data incluir uma configuração de ano; false, caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

isRequired()

Determina se o participante precisa responder à pergunta.

Retornar

Boolean: se o participante precisa responder à pergunta

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setGeneralFeedback(feedback)

Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta que não tem uma resposta correta ou incorreta (ou seja, perguntas que exigem avaliação manual).

Parâmetros

Nome	Tipo	Descrição
feedback	QuizFeedback	o novo feedback

Retornar

DateItem: este DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setHelpText(text)

Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como ImageItems, PageBreakItems e SectionHeaderItems).

Parâmetros

Nome	Tipo	Descrição
text	String	o novo texto de ajuda

Retornar

DateItem: este DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setIncludesYear(enableYear)

Define se o item de data inclui uma configuração de ano. O padrão para novos itens de data é true.

Parâmetros

Nome	Tipo	Descrição
enableYear	Boolean	true se a data incluir uma configuração de ano; false, caso contrário

Retornar

DateItem: este DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setPoints(points)

Define o número de pontos de um item que pode ser avaliado. O padrão para novos itens é 0.

Parâmetros

Nome	Tipo	Descrição
points	Integer	o número de pontos que um item de pergunta vale

Retornar

DateItem: este DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setRequired(enabled)

Define se o respondente precisa responder à pergunta.

Parâmetros

Nome	Tipo	Descrição
enabled	Boolean	se o participante precisa responder à pergunta

Retornar

DateItem: o item atual (para encadeamento)

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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

---

setTitle(title)

Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Parâmetros

Nome	Tipo	Descrição
title	String	o novo título ou texto do cabeçalho

Retornar

DateItem: este DateItem, para encadeamento

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

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