É um item de pergunta que permite que o participante indique um período. Os itens podem ser acessados ou
criados a partir de um Form
. Quando usados em um teste, estes itens são avaliados.
// Open a form by ID and add a new duration item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
createResponse(hours, minutes, seconds) | ItemResponse | Cria um novo ItemResponse para esse item de data. |
duplicate() | DurationItem | Cria uma cópia desse item e a anexa ao final do formulário. |
getGeneralFeedback() | QuizFeedback | Retorna o feedback que é exibido aos participantes quando eles respondem a uma pergunta de avaliação. |
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 | Acessa o índice do item entre todos os itens no formulário. |
getPoints() | Integer | Retorna a pontuação de um item avaliado. |
getTitle() | String | Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem ). |
getType() | ItemType | Recebe o tipo do item, representado como ItemType . |
isRequired() | Boolean | Determina se o participante precisa responder à pergunta. |
setGeneralFeedback(feedback) | DurationItem | Define o feedback a ser exibido aos participantes quando eles responderem a uma pergunta de classificação que não tem uma resposta correta ou incorreta (ou seja, perguntas que exigem avaliação manual). |
setHelpText(text) | DurationItem | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems , PageBreakItems e SectionHeaderItems ). |
setPoints(points) | DurationItem | Define o número de pontos que um item classificável vale. |
setRequired(enabled) | DurationItem | Define se o participante precisa responder à pergunta. |
setTitle(title) | DurationItem | Define o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem ). |
Documentação detalhada
createResponse(hours, minutes, seconds)
Cria um novo ItemResponse
para esse item de data. Os argumentos hours
, minutes
e seconds
são melhor representados como números inteiros de 0
a 72
para
hours
e 0
a 59
para minutes
e seconds
. Os valores que
excedem esses limites são fixados: por exemplo, 24, 60, 90
é interpretado como 24:59:59.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
hours | Integer | as horas, representadas como um número inteiro de 0 a 72 |
minutes | Integer | os minutos, representados como um número inteiro de 0 a 59 |
seconds | Integer | os segundos, representados como um número inteiro de 0 a 59 |
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 desse item e a anexa ao final do formulário.
Retornar
DurationItem
: uma cópia deste DurationItem
, 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 que é exibido aos participantes quando eles respondem a uma pergunta de avaliação.
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 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()
Acessa 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 a pontuação de um item avaliado.
Retornar
Integer
: o número de pontos por 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()
Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um SectionHeaderItem
).
Retornar
String
: o título ou 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()
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 a ser exibido aos participantes quando eles responderem a uma pergunta de classificação 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
DurationItem
: este DurationItem
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
DurationItem
: este DurationItem
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 que um item classificável vale. O padrão para novos itens é 0.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
points | Integer | o número de pontos em que um item de pergunta vale |
Retornar
DurationItem
: este DurationItem
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 participante precisa responder à pergunta.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
enabled | Boolean | se o participante precisa responder à pergunta |
Retornar
DurationItem
: 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 de 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
DurationItem
: este DurationItem
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