Class ScaleItem

ScaleItem

Um item de pergunta que permite que o participante escolha uma opção em 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

Métodos

MétodoTipo de retornoBreve descrição
createResponse(response)ItemResponseCria um novo ItemResponse para este item de escala.
duplicate()ScaleItemCria uma cópia deste item e a anexa ao final do formulário.
getGeneralFeedback()QuizFeedback|nullRetorna o feedback mostrado aos participantes quando eles respondem a uma pergunta avaliável.
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.
getLeftLabel()StringRecebe o marcador do limite inferior da escala, se houver.
getLowerBound()IntegerRecebe o limite inferior da escala.
getPoints()IntegerRetorna o valor de um item avaliável.
getRightLabel()StringRecebe o rótulo do limite superior da escala, se houver.
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.
getUpperBound()IntegerRecebe o limite superior da escala.
isRequired()BooleanDetermina se o participante precisa responder à pergunta.
setBounds(lower, upper)ScaleItemDefine os limites inferior e superior da escala.
setGeneralFeedback(feedback)ScaleItemDefine 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)ScaleItemDefine 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)ScaleItemDefine rótulos para os limites inferior e superior da escala.
setPoints(points)ScaleItemDefine o número de pontos que um item avaliável vale.
setRequired(enabled)ScaleItemDefine se o participante precisa responder à pergunta.
setTitle(title)ScaleItemDefine 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 escala. Gera uma exceção se o argumento response estiver fora dos limites definidos para o item.

Parâmetros

NomeTipoDescrição
responseIntegeruma resposta de valor para este item de escala

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

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

Retornar

QuizFeedback|null: 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

getLeftLabel()

Recebe o marcador do limite inferior da escala, se houver.

Retornar

String: o rótulo do 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.

Retornar

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

getRightLabel()

Recebe o rótulo do limite superior da escala, se houver.

Retornar

String: o marcador do 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).

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

getUpperBound()

Recebe o limite superior da escala.

Retornar

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

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, incluindo esses dois valores. Uma nova escala tem 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

NomeTipoDescrição
lowerIntegero novo limite inferior
upperIntegero novo limite superior

Retornar

ScaleItem: este ScaleItem, para encadeamento

Gera

Error: se o limite inferior ou superior 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 avaliável que não tem uma resposta certa ou errada (ou seja, perguntas que exigem avaliação manual).

Parâmetros

NomeTipoDescrição
feedbackQuizFeedbacko novo feedback

Retornar

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

NomeTipoDescrição
textStringo novo texto de ajuda

Retornar

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

NomeTipoDescrição
lowerStringo novo marcador do limite inferior
upperStringo novo marcador do limite superior

Retornar

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

Parâmetros

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

Retornar

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

Parâmetros

NomeTipoDescrição
enabledBooleanse o entrevistado precisa responder à pergunta

Retornar

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

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

Retornar

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