Class ParagraphTextItem

ParagraphTextItem

Uma pergunta que permite que o entrevistado insira um bloco de texto. 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 paragraph text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 do item de texto do parágrafo.
createResponse(response)	ItemResponse	Cria um novo ItemResponse para este item de texto de parágrafo.
duplicate()	ParagraphTextItem	Cria uma cópia deste item e a anexa ao final do formulário.
getGeneralFeedback()	QuizFeedback	Retorna o feedback mostrado aos participantes quando eles respondem a uma pergunta avaliável.
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	Recebe o índice do item entre todos os itens do formulário.
getPoints()	Integer	Retorna o valor de um item avaliável.
getTitle()	String	Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
getType()	ItemType	Recebe o tipo do item, representado como um ItemType.
isRequired()	Boolean	Determina se o participante precisa responder à pergunta.
setGeneralFeedback(feedback)	ParagraphTextItem	Define o feedback que será mostrado aos participantes quando eles responderem a uma pergunta avaliável que não tem uma resposta certa ou errada (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 avaliá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 do cabeçalho, no caso de um SectionHeaderItem).
setValidation(validation)	ParagraphTextItem	Define a validação de dados para este item de texto do parágrafo.

Documentação detalhada

clearValidation()

Remove qualquer validação de dados do 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 este item de texto de 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 deste item e a anexa ao final do formulário.

Retornar

ParagraphTextItem: uma duplicata de 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 mostrado aos participantes quando eles respondem a uma pergunta avaliável.

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 a 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()

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 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 o valor de um item avaliável.

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

---

getTitle()

Recebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).

Retornar

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

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 um 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: indica se o entrevistado 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 que será mostrado aos participantes quando eles responderem a uma pergunta avaliável que não tem uma resposta certa ou errada (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 avaliável vale. 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

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 entrevistado 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 do 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 este item de texto do parágrafo. Transmitir null ou uma instância ParagraphTextValidation em que nenhuma função de exigência foi chamada remove qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
validation	ParagraphTextValidation	um ParagraphTextValidation a ser aplicado 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