Esta página foi traduzida pela API Cloud Translation.

Class TimeItem

Um item de pergunta que permite ao participante indicar uma hora do dia. Os itens podem ser acessados ou criado com base em um Form. Quando usados em um teste, esses itens são avaliados.

// Open a form by ID and add a new time item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTimeItem();
item.setTitle('What time do you usually wake up in the morning?');

Métodos

Método	Tipo de retorno	Breve descrição
`createResponse(hour, minute)`	`ItemResponse`	Cria um novo `ItemResponse` para esse item de tempo.
`duplicate()`	`TimeItem`	Cria uma cópia desse item e a anexa ao final do formulário.
`getGeneralFeedback()`	`QuizFeedback`	Retorna o feedback que é mostrado aos participantes quando eles respondem a uma pergunta que pode ser avaliada.
`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`	Extrai o identificador exclusivo do item.
`getIndex()`	`Integer`	Recebe o índice do item entre todos os itens do formulário.
`getPoints()`	`Integer`	Retorna a pontuação de um item que pode ser avaliado.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como `ItemType`.
`isRequired()`	`Boolean`	Determina se o respondente precisa responder à pergunta.
`setGeneralFeedback(feedback)`	`TimeItem`	Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta com nota que não têm uma resposta correta ou incorreta (ou seja, perguntas que exigem correção manual).
`setHelpText(text)`	`TimeItem`	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)`	`TimeItem`	Define o número de pontos de um item que pode ser avaliado.
`setRequired(enabled)`	`TimeItem`	Define se o participante precisa responder à pergunta.
`setTitle(title)`	`TimeItem`	Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`.

Documentação detalhada

`createResponse(hour, minute)`

Cria um novo ItemResponse para esse item de tempo. Os argumentos hour e minute são melhor representados como números inteiros de 0 a 23 e de 0 a 59, respectivamente. Se excederem esses limites, eles se comportarão como em um relógio: por exemplo, 10, 90 é interpretado como 11:30 e -1, 60 é interpretado como 00:00.

Parâmetros

Nome	Tipo	Descrição
`hour`	`Integer`	a hora, representada como um número inteiro de `0` a `23`
`minute`	`Integer`	o minuto da hora, representado como um número inteiro de `0` a `59`

Retornar

ItemResponse: a resposta do item.

Autorização

Os scripts que usam esse método precisam de 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

TimeItem: uma cópia deste TimeItem para encadeamento.

Autorização

Os scripts que usam esse método precisam de 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 é mostrado aos participantes quando eles respondem a uma pergunta que pode ser avaliada.

Retornar

QuizFeedback: o feedback, se houver.

Autorização

Os scripts que usam esse método precisam de 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 precisam de autorização com um ou mais dos seguintes escopos:

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

`getId()`

Extrai o identificador exclusivo do item.

Retornar

Integer: o código do item.

Autorização

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

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

`getIndex()`

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

Retornar

Integer: o índice do item.

Autorização

Os scripts que usam esse método precisam de 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 que pode ser avaliado.

Retornar

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

Autorização

Os scripts que usam esse método precisam de 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 uma SectionHeaderItem).

Retornar

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

Autorização

Os scripts que usam esse método precisam de 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 ItemType.

Retornar

ItemType: o tipo do item.

Autorização

Os scripts que usam esse método precisam de 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 respondente precisa responder à pergunta.

Retornar

Boolean: se o participante precisa responder à pergunta.

Autorização

Os scripts que usam esse método precisam de 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 com nota que não têm uma resposta correta ou incorreta (ou seja, perguntas que exigem correção manual).

Parâmetros

Nome	Tipo	Descrição
`feedback`	`QuizFeedback`	o novo feedback

Retornar

TimeItem: este TimeItem, para encadeamento

Autorização

Os scripts que usam esse método precisam de 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

TimeItem: este TimeItem, para encadeamento

Autorização

Os scripts que usam esse método precisam de 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

TimeItem: este TimeItem, para encadeamento

Autorização

Os scripts que usam esse método precisam de 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 entrevistado deve responder à pergunta

Retornar

TimeItem: o item atual (para encadeamento).

Autorização

Os scripts que usam esse método precisam de 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 uma SectionHeaderItem.

Parâmetros

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

Retornar

TimeItem: este TimeItem, para encadeamento

Autorização

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

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