Esta página foi traduzida pela API Cloud Translation.

Class ScaleItem

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()`

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

`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