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étodo | Tipo de retorno | Breve descrição |
---|---|---|
clearValidation() | TextItem | Remove qualquer validação de dados para este item de texto. |
createResponse(response) | ItemResponse | Cria um novo ItemResponse para esse item de texto. |
duplicate() | TextItem | 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 . |
isRequired() | Boolean | Determina se o respondente precisa responder à pergunta. |
setGeneralFeedback(feedback) | TextItem | 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) | TextItem | 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) | TextItem | Define o número de pontos de um item que pode ser avaliado. |
setRequired(enabled) | TextItem | Define se o participante precisa responder à pergunta. |
setTitle(title) | TextItem | Define o título do item, às vezes chamado de texto de cabeçalho, no caso de uma SectionHeaderItem . |
setValidation(validation) | TextItem | Define 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
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 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()
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
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
Nome | Tipo | Descrição |
---|---|---|
text | String | o 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
Nome | Tipo | Descrição |
---|---|---|
points | Integer | o 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
Nome | Tipo | Descrição |
---|---|---|
enabled | Boolean | se 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
Nome | Tipo | Descrição |
---|---|---|
title | String | o 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
Nome | Tipo | Descrição |
---|---|---|
validation | TextValidation | um 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