Class CheckboxItem

Um item de pergunta que permite ao participante selecionar uma ou mais caixas de seleção, além de um campo "outro" opcional. Os itens são criados ou acessados de um Form usando métodos como Form.addCheckboxItem(). Quando usados em um teste, esses itens são corrigidos automaticamente.

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

Métodos

Método	Tipo de retorno	Breve descrição
`clearValidation()`	`CheckboxItem`	Remove qualquer validação de dados para este item de caixa de seleção.
`createChoice(value)`	`Choice`	Cria uma nova opção.
`createChoice(value, isCorrect)`	`Choice`	Cria uma nova opção.
`createResponse(responses)`	`ItemResponse`	Cria um novo `ItemResponse` para este item de caixa de seleção.
`duplicate()`	`CheckboxItem`	Cria uma cópia deste item e a adiciona ao final do formulário.
`getChoices()`	`Choice[]`	Recebe todas as opções de um item.
`getFeedbackForCorrect()`	`QuizFeedback\|null`	Retorna o feedback mostrado aos participantes quando eles respondem corretamente a uma pergunta.
`getFeedbackForIncorrect()`	`QuizFeedback\|null`	Retorna o feedback mostrado aos participantes quando eles respondem incorretamente a uma pergunta.
`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.
`getPoints()`	`Integer`	Retorna a pontuação de um item avaliável.
`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`.
`hasOtherOption()`	`Boolean`	Determina se o item tem uma opção "Outros".
`isRequired()`	`Boolean`	Determina se o participante precisa responder à pergunta.
`setChoiceValues(values)`	`CheckboxItem`	Define as opções de um item com base em uma matriz de strings.
`setChoices(choices)`	`CheckboxItem`	Define uma matriz de opções para um item.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	Define o feedback que será mostrado aos participantes quando eles responderem corretamente a uma pergunta.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	Define o feedback que será mostrado aos participantes quando eles responderem incorretamente a uma pergunta.
`setHelpText(text)`	`CheckboxItem`	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)`	`CheckboxItem`	Define o número de pontos que um item avaliável vale.
`setRequired(enabled)`	`CheckboxItem`	Define se o participante precisa responder à pergunta.
`setTitle(title)`	`CheckboxItem`	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	Define a validação de dados para este item de caixa de seleção.
`showOtherOption(enabled)`	`CheckboxItem`	Define se o item tem uma opção "Outros".

Documentação detalhada

`clearValidation()`

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

Retornar

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

`createChoice(value)`

Cria uma nova opção.

Parâmetros

Nome	Tipo	Descrição
`value`	`String`	o valor da opção, que os participantes veem como um rótulo ao acessar o formulário

Retornar

Choice: a nova opção

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

`createChoice(value, isCorrect)`

Cria uma nova opção.

Parâmetros

Nome	Tipo	Descrição
`value`	`String`	o valor da opção, que os participantes veem como um rótulo ao acessar o formulário
`isCorrect`	`Boolean`	se a escolha é uma resposta correta

Retornar

Choice: a nova opção

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

`createResponse(responses)`

Cria um novo ItemResponse para este item de caixa de seleção. O argumento responses é uma matriz String[] que contém valores a serem verificados. Gera uma exceção se algum valor não corresponder a uma opção válida para esse item, a menos que showOtherOption(enabled) esteja definido como true.

Parâmetros

Nome	Tipo	Descrição
`responses`	`String[]`	Uma matriz de respostas válidas para este item de múltipla escolha.

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 adiciona ao final do formulário.

Retornar

CheckboxItem: uma duplicata de CheckboxItem 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

`getChoices()`

Recebe todas as opções de um item.

Retornar

Choice[]: uma matriz de opções

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

`getFeedbackForCorrect()`

Retorna o feedback mostrado aos participantes quando eles respondem corretamente a uma pergunta.

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

`getFeedbackForIncorrect()`

Retorna o feedback mostrado aos participantes quando eles respondem incorretamente a uma pergunta.

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

`getPoints()`

Retorna a pontuação 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

`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

`hasOtherOption()`

Determina se o item tem uma opção "Outros".

Retornar

Boolean: true se o item tiver uma opção "Outros"; false se não tiver

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

`setChoiceValues(values)`

Define as opções de um item com base em uma matriz de strings. Gera uma exceção se a matriz fornecida estiver vazia.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

Parâmetros

Nome	Tipo	Descrição
`values`	`String[]`	a matriz de valores de escolha, que os participantes veem como rótulos ao visualizar o formulário

Retornar

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

`setChoices(choices)`

Define uma matriz de opções para um item. Gera uma exceção se a matriz fornecida estiver vazia ou contiver um elemento null.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

Parâmetros

Nome	Tipo	Descrição
`choices`	`Choice[]`	uma variedade de opções

Retornar

CheckboxItem: CheckboxItem para encadeamento

Gera

Error: se a matriz especificada for null, estiver vazia ou contiver um elemento null

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

`setFeedbackForCorrect(feedback)`

Define o feedback que será mostrado aos participantes quando eles responderem corretamente a uma pergunta.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setText('Dogs rule, cats drool.').build(),
);

Parâmetros

Nome	Tipo	Descrição
`feedback`	`QuizFeedback`	o novo feedback. Um valor nulo vai limpar o feedback.

Retornar

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

`setFeedbackForIncorrect(feedback)`

Define o feedback que será mostrado aos participantes quando eles responderem incorretamente a uma pergunta.

Parâmetros

Nome	Tipo	Descrição
`feedback`	`QuizFeedback`	o novo feedback

Retornar

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

Retornar

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

Nome	Tipo	Descrição
`points`	`Integer`	o número de pontos que um item de pergunta vale

Retornar

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

Nome	Tipo	Descrição
`enabled`	`Boolean`	se o entrevistado precisa responder à pergunta

Retornar

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

Retornar

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

`setValidation(validation)`

Define a validação de dados para este item de caixa de seleção. Transmitir um valor nulo ou uma validação sem funções de requisito chamadas remove qualquer validação anterior.

Parâmetros

Nome	Tipo	Descrição
`validation`	`CheckboxValidation`	um CheckboxValidation a ser aplicado a este item.

Retornar

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

`showOtherOption(enabled)`

Define se o item tem uma opção "Outros". O padrão para um novo CheckboxItem ou MultipleChoiceItem é false.

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	`true` se o item tiver uma opção "Outros"; `false` se não tiver.

Retornar

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

Class CheckboxItem Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Métodos

Documentação detalhada

clearValidation()

Retornar

Autorização

createChoice(value)

Parâmetros

Retornar

Autorização

createChoice(value, isCorrect)

Parâmetros

Retornar

Autorização

createResponse(responses)

Parâmetros

Retornar

Autorização

duplicate()

Retornar

Autorização

getChoices()

Retornar

Autorização

getFeedbackForCorrect()

Retornar

Autorização

getFeedbackForIncorrect()

Retornar

Autorização

getHelpText()

Retornar

Autorização

getId()

Retornar

Autorização

getIndex()

Retornar

Autorização

getPoints()

Retornar

Autorização

getTitle()

Retornar

Autorização

getType()

Retornar

Autorização

hasOtherOption()

Retornar

Autorização

isRequired()

Retornar

Autorização

setChoiceValues(values)

Parâmetros

Retornar

Autorização

setChoices(choices)

Parâmetros

Retornar

Gera

Autorização

setFeedbackForCorrect(feedback)

Parâmetros

Retornar

Autorização

setFeedbackForIncorrect(feedback)

Parâmetros

Retornar

Autorização

setHelpText(text)

Parâmetros

Retornar

Autorização

setPoints(points)

Parâmetros

Retornar

Autorização

setRequired(enabled)

Class CheckboxItem

`clearValidation()`

`createChoice(value)`

`createChoice(value, isCorrect)`

`createResponse(responses)`

`duplicate()`

`getChoices()`

`getFeedbackForCorrect()`

`getFeedbackForIncorrect()`

`getHelpText()`

`getId()`

`getIndex()`

`getPoints()`

`getTitle()`

`getType()`

`hasOtherOption()`

`isRequired()`

`setChoiceValues(values)`

`setChoices(choices)`

`setFeedbackForCorrect(feedback)`

`setFeedbackForIncorrect(feedback)`

`setHelpText(text)`

`setPoints(points)`

`setRequired(enabled)`

`setTitle(title)`

`setValidation(validation)`

`showOtherOption(enabled)`