Esta página foi traduzida pela API Cloud Translation.

Class DateItem

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

// Open a form by ID and add a new date item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 esse item de data.
`duplicate()`	`DateItem`	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`.
`includesYear()`	`Boolean`	Determina se o item de data inclui uma opção de ano.
`isRequired()`	`Boolean`	Determina se o respondente precisa responder à pergunta.
`setGeneralFeedback(feedback)`	`DateItem`	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)`	`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 participante precisa responder à pergunta.
`setTitle(title)`	`DateItem`	Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma `SectionHeaderItem`.

Documentação detalhada

`createResponse(response)`

Cria um novo ItemResponse para esse item de data. Os campos de horário do Date são ignorados. por padrão, apenas os campos ano, mês e dia são usados. Se setIncludesYear(enabled) for definido como false, o ano será também será ignorada.

Parâmetros

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

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

DateItem: uma cópia deste DateItem 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

`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 se não for

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

DateItem: este DateItem, 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

DateItem: este DateItem, 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

`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 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

DateItem: este DateItem, 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

DateItem: 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

DateItem: este DateItem, 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