Um item de pergunta que permite ao participante indicar um período de tempo. 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 duration item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addDurationItem(); item.setTitle('How long can you hold your breath?');
Métodos
| Método | Tipo de retorno | Breve descrição |
|---|---|---|
create | Item | Cria um novo Item para este item de data. |
duplicate() | Duration | Cria uma cópia do item e a anexa ao final do formulário. |
get | Quiz | Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota. |
get | String | Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section). |
get | Integer | Recebe o identificador exclusivo do item. |
get | Integer | Consegue o índice do item entre todos os itens no formulário. |
get | Integer | Retorna o valor em pontos de um item que pode ser avaliado. |
get | String | Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section). |
get | Item | Recebe o tipo do item, representado como um Item. |
is | Boolean | Determina se o participante precisa responder à pergunta. |
set | Duration | 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). |
set | Duration | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section). |
set | Duration | Define o número de pontos de um item que pode ser avaliado. |
set | Duration | Define se o respondente precisa responder à pergunta. |
set | Duration | Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section). |
Documentação detalhada
create Response(hours, minutes, seconds)
Cria um novo Item para este 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
ultrapassam esses limites são limitados: 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
Item: 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
Duration: uma cópia desta Duration, 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
get General Feedback()
Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta que pode receber nota.
Retornar
Quiz: 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
get Help Text()
Recebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section).
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
get Id()
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
get Index()
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
get Points()
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
get Title()
Extrai o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section).
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
get Type()
is Required()
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
set General Feedback(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 | Quiz | o novo feedback |
Retornar
Duration: este Duration, 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
set Help Text(text)
Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout como Image, Page e Section).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
text | String | o novo texto de ajuda |
Retornar
Duration: este Duration, 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
set Points(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
Duration: este Duration, 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
set Required(enabled)
Define se o respondente precisa responder à pergunta.
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
enabled | Boolean | se o participante precisa responder à pergunta |
Retornar
Duration: 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
set Title(title)
Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um Section).
Parâmetros
| Nome | Tipo | Descrição |
|---|---|---|
title | String | o novo título ou texto do cabeçalho |
Retornar
Duration: este Duration, 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