Class TextItem

TextItem

Um item de pergunta que permite ao participante inserir uma única linha de texto. Os itens podem ser acessados ou criados com base em um Form. Quando usados em um teste, esses itens são avaliados.

// Open a form by ID and add a new text item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addTextItem();
item.setTitle('What is your name?');

Métodos

MétodoTipo de retornoBreve descrição
clearValidation()TextItemRemove qualquer validação de dados para este item de texto.
createResponse(response)ItemResponseCria um novo ItemResponse para esse item de texto.
duplicate()TextItemCria uma cópia desse item e a anexa ao final do formulário.
getGeneralFeedback()QuizFeedbackRetorna o feedback que é mostrado aos participantes quando eles respondem a uma pergunta que pode ser avaliada.
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()IntegerExtrai 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 que pode ser avaliado.
getTitle()StringRecebe o título do item (às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem).
getType()ItemTypeRecebe o tipo do item, representado como ItemType.
isRequired()BooleanDetermina se o respondente precisa responder à pergunta.
setGeneralFeedback(feedback)TextItemDefine 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)TextItemDefine 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)TextItemDefine o número de pontos de um item que pode ser avaliado.
setRequired(enabled)TextItemDefine se o participante precisa responder à pergunta.
setTitle(title)TextItemDefine o título do item, às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem.
setValidation(validation)TextItemDefine a validação de dados para este item de texto.

Documentação detalhada

clearValidation()

Remove qualquer validação de dados para este item de texto.

Retornar

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

createResponse(response)

Cria um novo ItemResponse para esse item de texto.

Parâmetros

NomeTipoDescrição
responseStringuma resposta à pergunta feita pelo item

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

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

NomeTipoDescrição
feedbackQuizFeedbacko novo feedback

Retornar

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

NomeTipoDescrição
textStringo novo texto de ajuda

Retornar

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

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

Retornar

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

NomeTipoDescrição
enabledBooleanse o entrevistado deve responder à pergunta

Retornar

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

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

Retornar

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

setValidation(validation)

Define a validação de dados para este item de texto. Transmitir um valor nulo ou uma validação sem exigem funções chamadas removem qualquer validação anterior.

Parâmetros

NomeTipoDescrição
validationTextValidationum TextValidation para aplicar a este item.

Retornar

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