Uma única opção associada a um tipo de Item
que oferece suporte a opções como CheckboxItem
, ListItem
ou MultipleChoiceItem
.
// Create a new form and add a multiple-choice item. var form = FormApp.create('Form Name'); var item = form.addMultipleChoiceItem(); item.setTitle('Do you prefer cats or dogs?') .setChoices([ item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE), item.createChoice('Dogs', FormApp.PageNavigationType.RESTART) ]); // Add another page because navigation has no effect on the last page. form.addPageBreakItem().setTitle('You chose well!'); // Log the navigation types that each choice results in. var choices = item.getChoices(); for (var i = 0; i < choices.length; i++) { Logger.log('If the respondent chooses "%s", the form will %s.', choices[i].getValue(), choices[i].getPageNavigationType()); }
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
getGotoPage() | PageBreakItem | Acessa o PageBreakItem definido como um destino de GO_TO_PAGE
se o participante selecionar essa opção e concluir a página atual. |
getPageNavigationType() | PageNavigationType | Recebe o PageNavigationType que ocorre se o participante selecionar essa opção e
concluir a página atual. |
getValue() | String | Recebe o valor da escolha, que os participantes veem como um rótulo ao visualizar o formulário. |
isCorrectAnswer() | Boolean | Define se a escolha é uma resposta correta para a pergunta. |
Documentação detalhada
getGotoPage()
Acessa o PageBreakItem
definido como um destino de GO_TO_PAGE
se o participante selecionar essa opção e concluir a página atual. Esse método se aplica somente
a opções associadas a MultipleChoiceItems
. Para outras opções,
retorna null
.
Retornar
PageBreakItem
: o destino GO_TO_PAGE
para esta escolha, ou null
se não houver nenhum
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
getValue()
Recebe o valor da escolha, que os participantes veem como um rótulo ao visualizar o formulário.
Retornar
String
: o valor da escolha
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
isCorrectAnswer()
Define se a escolha é uma resposta correta para a pergunta. Esse método só se aplica a perguntas que fazem parte de um teste. Para formulários que não são de teste, ele retorna "false".
Retornar
Boolean
: se a escolha é uma resposta correta.
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