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