Uma única escolha 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 | Recebe o PageBreakItem definido como um destino GO_TO_PAGE
se a pessoa que responde selecionar essa opção e concluir a página atual. |
getPageNavigationType() | PageNavigationType | Recebe a PageNavigationType que ocorre se o respondente selecionar essa opção e
completar a página atual. |
getValue() | String | Recebe o valor da escolha, que os entrevistados veem como um rótulo ao visualizar o formulário. |
isCorrectAnswer() | Boolean | Descobre se a escolha é uma resposta correta para a pergunta. |
Documentação detalhada
getGotoPage()
Recebe o PageBreakItem
definido como um destino GO_TO_PAGE
se a pessoa que responde selecionar essa opção e concluir a página atual. Esse método se aplica apenas
às opções associadas a MultipleChoiceItems
. Para outras opções,
ele retorna null
.
Retorno
PageBreakItem
: o destino GO_TO_PAGE
para essa opção, 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 entrevistados veem como um rótulo ao visualizar o formulário.
Retorno
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()
Descobre se a escolha é uma resposta correta para a pergunta. Esse método só se aplica a perguntas que fazem parte de um teste. Em formulários que não são de teste, ele retorna "false".
Retorno
Boolean
: indica se a resposta está 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