Esta página foi traduzida pela API Cloud Translation.

Class ParagraphTextItem

(link em inglês)

É um item de pergunta que permite ao participante inserir um bloco de texto. 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 paragraph text item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addParagraphTextItem();
item.setTitle('What is your address?');

Métodos

Método	Tipo de retorno	Breve descrição
`clearValidation()`	`ParagraphTextItem`	Remove qualquer validação de dados para esse item de texto do parágrafo.
`createResponse(response)`	`ItemResponse`	Cria um novo `ItemResponse` para esse item de texto do parágrafo.
`duplicate()`	`ParagraphTextItem`	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)`	`ParagraphTextItem`	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)`	`ParagraphTextItem`	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)`	`ParagraphTextItem`	Define o número de pontos que um item classificável vale.
`setRequired(enabled)`	`ParagraphTextItem`	Define se o participante precisa responder à pergunta.
`setTitle(title)`	`ParagraphTextItem`	Define o título do item (às vezes chamado de texto de cabeçalho, no caso de um `SectionHeaderItem`).
`setValidation(validation)`	`ParagraphTextItem`	Define a validação de dados para esse item de texto do parágrafo.

Documentação detalhada

`clearValidation()`

Remove qualquer validação de dados para esse item de texto do parágrafo.

Retornar

ParagraphTextItem: este ParagraphTextItem 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

`createResponse(response)`

Cria um novo ItemResponse para esse item de texto do parágrafo.

Parâmetros

Nome	Tipo	Descrição
`response`	`String`	uma resposta à pergunta feita pelo item

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

ParagraphTextItem: uma cópia deste ParagraphTextItem, 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()`

Recebe o tipo do item, representado como 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

`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

ParagraphTextItem: este ParagraphTextItem 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

ParagraphTextItem: este ParagraphTextItem 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

ParagraphTextItem: este ParagraphTextItem 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

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

ParagraphTextItem: este ParagraphTextItem 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

`setValidation(validation)`

Define a validação de dados para esse item de texto do parágrafo. Transmitir um valor nulo ou uma validação sem qualquer função de exigência chamada removerá qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
`validation`	`ParagraphTextValidation`	um ParagraphTextValidation para aplicar a este item.

Retornar

ParagraphTextItem: este ParagraphTextItem 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