Class ParagraphTextItem

ParagraphTextItem

Um item de pergunta que permite ao respondente inserir um bloco de texto. Os itens podem ser acessados ou criados com base em uma Form. Quando usados em um teste, esses 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étodoTipo de retornoBreve descrição
clearValidation()ParagraphTextItemRemove qualquer validação de dados para este item de texto do parágrafo.
createResponse(response)ItemResponseCria um novo ItemResponse para esse item de texto do parágrafo.
duplicate()ParagraphTextItemCria uma cópia desse item e a anexa ao final do formulário.
getGeneralFeedback()QuizFeedbackRetorna o feedback que é exibido aos participantes quando eles respondem a uma pergunta que pode ser classificada.
getHelpText()StringRecebe o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems, PageBreakItems e SectionHeaderItems).
getId()IntegerRecebe o identificador exclusivo do item.
getIndex()IntegerRecebe o índice do item entre todos os itens do formulário.
getPoints()IntegerRetorna a pontuação de um item com nota.
getTitle()StringRecebe o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
getType()ItemTypeRecebe o tipo do item, representado como um ItemType.
isRequired()BooleanDetermina se o entrevistado deve responder à pergunta.
setGeneralFeedback(feedback)ParagraphTextItemDefine o feedback que será mostrado aos participantes quando eles responderem a uma pergunta que pode ser avaliada sem uma resposta correta ou incorreta (por exemplo, perguntas que exigem avaliação manual).
setHelpText(text)ParagraphTextItemDefine 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)ParagraphTextItemDefine o número de pontos para um item classificável.
setRequired(enabled)ParagraphTextItemDefine se o respondente precisa responder à pergunta.
setTitle(title)ParagraphTextItemDefine o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem).
setValidation(validation)ParagraphTextItemDefine a validação de dados para este item de texto do parágrafo.

Documentação detalhada

clearValidation()

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

Retorno

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

NomeTipoDescrição
responseStringuma resposta à pergunta feita pelo item

Retorno

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.

Retorno

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 que pode ser classificada.

Retorno

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).

Retorno

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

getId()

Recebe o identificador exclusivo do item.

Retorno

Integer: 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.

Retorno

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 com nota.

Retorno

Integer: o número de pontos de uma 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

getTitle()

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

Retorno

String: 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 um ItemType.

Retorno

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 entrevistado deve responder à pergunta.

Retorno

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 que será mostrado aos participantes quando eles responderem a uma pergunta que pode ser avaliada sem uma resposta correta ou incorreta (por exemplo, perguntas que exigem avaliação manual).

Parâmetros

NomeTipoDescrição
feedbackQuizFeedbacko novo feedback

Retorno

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

NomeTipoDescrição
textStringo novo texto de ajuda

Retorno

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 para um item classificável. O padrão para novos itens é 0.

Parâmetros

NomeTipoDescrição
pointsIntegero número de pontos em que um item da pergunta vale

Retorno

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 respondente precisa responder à pergunta.

Parâmetros

NomeTipoDescrição
enabledBooleanse o respondente deve responder à pergunta

Retorno

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

NomeTipoDescrição
titleStringo novo título ou texto do cabeçalho

Retorno

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 nulo ou uma validação sem qualquer função obrigatória chamada removerá qualquer validação anterior.

Parâmetros

NomeTipoDescrição
validationParagraphTextValidationum ParagraphTextValidation para aplicar a este item.

Retorno

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