Esta página foi traduzida pela API Cloud Translation.

Class MultipleChoiceItem

Um item de pergunta que permite ao entrevistado selecionar uma opção em uma lista de botões de opção ou em um campo "outro" opcional. Os itens podem ser acessados ou criados em 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 na página 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`	Cria 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[]`	Mostra todas as opções de um item.
`getFeedbackForCorrect()`	`QuizFeedback`	Retorna o feedback que é exibido aos entrevistados quando eles respondem corretamente a uma pergunta.
`getFeedbackForIncorrect()`	`QuizFeedback`	Retorna o feedback que é exibido aos entrevistados 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 com nota.
`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 "outro".
`isRequired()`	`Boolean`	Determina se o entrevistado deve 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á mostrado aos entrevistados quando eles responderem corretamente a uma pergunta.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	Define o feedback a ser mostrado aos entrevistados 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 para um item classificável.
`setRequired(enabled)`	`MultipleChoiceItem`	Define se o respondente precisa responder à pergunta.
`setTitle(title)`	`MultipleChoiceItem`	Define o título do item (às vezes chamado de texto do cabeçalho, no caso de um `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	Define se o item tem uma opção "outro".

Documentação detalhada

`createChoice(value)`

Cria uma nova opção.

Parâmetros

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

Retorno

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 entrevistados veem como um rótulo ao visualizar o formulário
`isCorrect`	`Boolean`	se a opção é uma resposta correta

Retorno

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 na página que pula para um determinado item de quebra de página. É equivalente a createChoice(value, navigationType) com navigationType definido como FormApp.PageNavigationType.GO_TO_PAGE. As opções que usam a navegação nas páginas não podem ser combinadas no mesmo item com aquelas que não usam a navegação.

A navegação ocorre depois que o participante conclui uma página que contém a opção e somente se ele tiver escolhido essa opção. Se o entrevistado tiver escolhido 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 também não afeta a última página do formulário.

Parâmetros

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

Retorno

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 opções que usam a navegação nas páginas não podem ser combinadas no mesmo item com aquelas que não a usam.

Parâmetros

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

Retorno

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

Cria um novo ItemResponse para esse item de múltipla escolha. Uma exceção vai ser gerada 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

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

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

Mostra todas as opções de um item.

Retorno

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 entrevistados quando eles respondem corretamente a uma pergunta.

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

`getFeedbackForIncorrect()`

Retorna o feedback que é exibido aos entrevistados quando eles respondem incorretamente a uma pergunta.

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

`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

`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

`hasOtherOption()`

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

Retorno

Boolean: true se o item tiver uma opção "outro"; 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 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

`setChoiceValues(values)`

Define as opções para um item de uma matriz de strings. Lança uma exceção se a matriz fornecida 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 de escolha, que os entrevistados veem como rótulos ao visualizar o formulário

Retorno

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 fornecida estiver vazia ou contiver 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

Retorno

MultipleChoiceItem: este MultipleChoiceItem, para encadeamento.

Gera

Error: se a matriz fornecida for null, 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 entrevistados 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`	o novo feedback. Um valor nulo vai apagar o feedback.

Retorno

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 mostrado aos entrevistados quando eles responderem incorretamente a uma pergunta.

Parâmetros

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

Retorno

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

Retorno

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

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

Parâmetros

Nome	Tipo	Descrição
`enabled`	`Boolean`	se o respondente deve responder à pergunta

Retorno

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

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 "outro". 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 "outro"; caso contrário, `false`

Retorno

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