Um item de pergunta que permite ao entrevistado escolher uma opção de uma sequência numerada de botões
de opção. 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 scale item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addScaleItem(); item.setTitle('Pick a number between 1 and 10') .setBounds(1, 10);
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
createResponse(response) | ItemResponse | Cria um novo ItemResponse para este item de balança. |
duplicate() | ScaleItem | 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 que pode ser classificada. |
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. |
getLeftLabel() | String | Recebe o rótulo para o limite inferior da escala, se houver. |
getLowerBound() | Integer | Recebe o limite inferior da escala. |
getPoints() | Integer | Retorna a pontuação de um item com nota. |
getRightLabel() | String | Recebe o rótulo para o limite superior da escala, se houver. |
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 . |
getUpperBound() | Integer | Recebe o limite superior da escala. |
isRequired() | Boolean | Determina se o entrevistado deve responder à pergunta. |
setBounds(lower, upper) | ScaleItem | Define os limites inferior e superior da escala. |
setGeneralFeedback(feedback) | ScaleItem | 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). |
setHelpText(text) | ScaleItem | Define o texto de ajuda do item (às vezes chamado de texto de descrição para itens de layout, como ImageItems , PageBreakItems e SectionHeaderItems ). |
setLabels(lower, upper) | ScaleItem | Define rótulos para os limites inferior e superior da escala. |
setPoints(points) | ScaleItem | Define o número de pontos para um item classificável. |
setRequired(enabled) | ScaleItem | Define se o respondente precisa responder à pergunta. |
setTitle(title) | ScaleItem | Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um SectionHeaderItem ). |
Documentação detalhada
createResponse(response)
Cria um novo ItemResponse
para este item de balança. Gera uma exceção se o argumento response
estiver fora dos limites definidos para o item.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
response | Integer | uma resposta com valor para este item de escala |
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
ScaleItem
: uma cópia deste ScaleItem
, 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
getLeftLabel()
Recebe o rótulo para o limite inferior da escala, se houver.
Retorno
String
: o rótulo para o limite inferior da escala.
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
getLowerBound()
Recebe o limite inferior da escala.
Retorno
Integer
: o limite inferior da escala.
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
getRightLabel()
Recebe o rótulo para o limite superior da escala, se houver.
Retorno
String
: o rótulo para o limite superior da escala.
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()
getUpperBound()
Recebe o limite superior da escala.
Retorno
Integer
: o limite superior da escala.
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
setBounds(lower, upper)
Define os limites inferior e superior da escala. O limite inferior precisa ser 0
ou 1
. O
limite superior precisa estar entre 3
e 10
. Uma nova escala assume como padrão um
limite inferior de 1
e um limite superior de 5
.
Gera uma exceção de script se os valores fornecidos estiverem fora dos limites permitidos. Os decimais são truncados para o número inteiro anterior.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
lower | Integer | o novo limite mínimo |
upper | Integer | o novo limite máximo |
Retorno
ScaleItem
: este ScaleItem
, para encadeamento.
Gera
Error
: se o limite mínimo ou máximo for inválido.
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
Nome | Tipo | Descrição |
---|---|---|
feedback | QuizFeedback | o novo feedback |
Retorno
ScaleItem
: este ScaleItem
, 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 |
Retorno
ScaleItem
: este ScaleItem
, 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
setLabels(lower, upper)
Define rótulos para os limites inferior e superior da escala.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
lower | String | o novo rótulo para o limite inferior |
upper | String | o novo rótulo para o limite superior |
Retorno
ScaleItem
: este ScaleItem
, 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
Nome | Tipo | Descrição |
---|---|---|
points | Integer | o número de pontos em que um item da pergunta vale |
Retorno
ScaleItem
: este ScaleItem
, 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
Nome | Tipo | Descrição |
---|---|---|
enabled | Boolean | se o respondente deve responder à pergunta |
Retorno
ScaleItem
: 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 |
Retorno
ScaleItem
: este ScaleItem
, 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