Esta página foi traduzida pela API Cloud Translation.

Class MultipleChoiceItem

É um item de pergunta que permite ao participante selecionar uma opção em uma lista de botões de opção ou um campo "quot;other" opcional". Os itens podem ser acessados ou criados a partir de um Form. Quando usados em um teste, esses itens são avaliados automaticamente.

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

Métodos

Método	Tipo de retorno	Breve descrição
`createChoice(value)`	`Choice`	Cria uma nova opção.
`createChoice(value, isCorrect)`	`Choice`	Cria uma nova opção.
`createChoice(value, navigationItem)`	`Choice`	Cria uma nova opção com uma opção de navegação que pula para um determinado item de quebra de página.
`createChoice(value, navigationType)`	`Choice`	Cria uma nova opção com uma opção de navegação nas páginas.
`createResponse(response)`	`ItemResponse`	Crie um novo `ItemResponse` para esse item de múltipla escolha.
`duplicate()`	`MultipleChoiceItem`	Cria uma cópia desse item e a anexa ao final do formulário.
`getChoices()`	`Choice[]`	Recebe todas as opções de um item.
`getFeedbackForCorrect()`	`QuizFeedback`	Retorna o feedback que é exibido aos participantes quando eles respondem corretamente a uma pergunta.
`getFeedbackForIncorrect()`	`QuizFeedback`	Retorna o feedback exibido 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`	Acessa o índice do item entre todos os itens no formulário.
`getPoints()`	`Integer`	Retorna a pontuação de um item avaliado.
`getTitle()`	`String`	Recebe o título do item (às vezes chamado de texto de cabeçalho, no caso de um `SectionHeaderItem`).
`getType()`	`ItemType`	Recebe o tipo do item, representado como `ItemType`.
`hasOtherOption()`	`Boolean`	Determina se o item tem uma opção "other"
`isRequired()`	`Boolean`	Determina se o participante precisa responder à pergunta.
`setChoiceValues(values)`	`MultipleChoiceItem`	Define as opções para um item de uma matriz de strings.
`setChoices(choices)`	`MultipleChoiceItem`	Define uma matriz de opções para um item.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	Define o feedback que será exibido aos participantes quando eles responderem corretamente a uma pergunta.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	Define o feedback a ser exibido aos participantes quando eles responderem incorretamente a uma pergunta.
`setHelpText(text)`	`MultipleChoiceItem`	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)`	`MultipleChoiceItem`	Define o número de pontos que um item classificável vale.
`setRequired(enabled)`	`MultipleChoiceItem`	Define se o participante precisa responder à pergunta.
`setTitle(title)`	`MultipleChoiceItem`	Define o título do item (às vezes chamado de texto de cabeçalho, no caso de um `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	Define se o item tem uma opção "other"

Documentação detalhada

`createChoice(value)`

Cria uma nova opção.

Parâmetros

Nome	Tipo	Descrição
`value`	`String`	o valor da escolha, que os participantes veem como um marcador ao visualizar 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 escolha, que os participantes veem como um marcador ao visualizar 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

`createChoice(value, navigationItem)`

Cria uma nova opção com uma opção de navegação que pula para um determinado item de quebra de página. Isso é equivalente a createChoice(value, navigationType) com navigationType definido como FormApp.PageNavigationType.GO_TO_PAGE. As opções que usam a navegação na página não podem ser combinadas no mesmo item com opções que não usam esse recurso.

A navegação na página ocorre depois que o participante conclui uma página que contém a opção e apenas se o participante escolher essa opção. Se o participante escolher várias opções com instruções de navegação na mesma página, somente a última opção de navegação terá efeito. A navegação nas páginas também não afeta a última página de um formulário.

Parâmetros

Nome	Tipo	Descrição
`value`	`String`	o valor da escolha, que os participantes veem como um marcador ao visualizar o formulário
`navigationItem`	`PageBreakItem`	o item para o qual navegar

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, navigationType)`

Cria uma nova opção com uma opção de navegação nas páginas. As escolhas que usam a navegação nas páginas não podem ser combinadas no mesmo item com opções que não usam esse recurso.

Parâmetros

Nome	Tipo	Descrição
`value`	`String`	o valor da escolha, que os participantes veem como um marcador ao visualizar o formulário
`navigationType`	`PageNavigationType`	o tipo de navegação da escolha

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

Crie um novo ItemResponse para esse item de múltipla escolha. Lança uma exceção se o argumento response não corresponder a uma escolha válida para esse item, a menos que showOtherOption(enabled) seja definido como true.

Parâmetros

Nome	Tipo	Descrição
`response`	`String`	uma resposta válida 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 desse item e a anexa ao final do formulário.

Retornar

MultipleChoiceItem: uma cópia deste MultipleChoiceItem, 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 que é exibido aos participantes quando eles respondem corretamente a uma pergunta.

Retornar

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

`getFeedbackForIncorrect()`

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

Retornar

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

Retornar

String: o texto de ajuda ou 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()`

Acessa o índice do item entre todos os itens no 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 avaliado.

Retornar

Integer: o número de pontos por 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 de cabeçalho, no caso de um SectionHeaderItem).

Retornar

String: o 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 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 "other"

Retornar

Boolean: true se o item tiver uma opção "other"; caso contrário, false

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: 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 para um item de uma matriz de strings. Lança uma exceção se a matriz especificada estiver vazia.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 escolhidos, que os participantes veem como marcadores ao visualizar o formulário

Retornar

MultipleChoiceItem: este MultipleChoiceItem 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. Lança uma exceção se a matriz especificada estiver vazia ou tiver um elemento null.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 matriz de opções

Retornar

MultipleChoiceItem: este MultipleChoiceItem para encadeamento

Gera

Error: se a matriz especificada for null, estiver vazia ou tiver 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á exibido aos participantes quando eles responderem corretamente a uma pergunta.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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().setDisplayText("Dogs rule, cats drool.").build());

Parâmetros

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

Retornar

MultipleChoiceItem: este MultipleChoiceItem 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 a ser exibido aos participantes quando eles responderem incorretamente a uma pergunta.

Parâmetros

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

Retornar

MultipleChoiceItem: este MultipleChoiceItem 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

MultipleChoiceItem: este MultipleChoiceItem 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 classificável vale. O padrão para novos itens é 0.

Parâmetros

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

Retornar

MultipleChoiceItem: este MultipleChoiceItem 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 participante precisa responder à pergunta

Retornar

MultipleChoiceItem: 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 de 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

MultipleChoiceItem: este MultipleChoiceItem 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 "other" 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 "other"; `false` se não

Retornar

MultipleChoiceItem: este MultipleChoiceItem 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