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 | Recebe o PageBreakItem definido como um destino GO_TO_PAGE .
se o participante selecionar essa opção e completar a página atual. |
getPageNavigationType() | PageNavigationType | Recebe o PageNavigationType que ocorre se o participante selecionar essa opção e
conclui a página atual. |
getValue() | String | Extrai o valor da opção, que os entrevistados veem como um marcador ao visualizar o formulário. |
isCorrectAnswer() | Boolean | Descobre se a opção é uma resposta correta para a pergunta. |
Documentação detalhada
getGotoPage()
Recebe o PageBreakItem
definido como um destino GO_TO_PAGE
.
se o participante selecionar essa opção e completar a página atual. Esse método se aplica apenas
às opções associadas a MultipleChoiceItems
; para outras opções,
ela retornará null
.
Retornar
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 precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getValue()
Extrai o valor da opção, que os entrevistados veem como um marcador ao visualizar o formulário.
Retornar
String
: o valor da escolha
Autorização
Os scripts que usam esse método precisam de 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 opção é uma resposta correta para a pergunta. Esse método só se aplica perguntas que fazem parte de um teste, para formulários que não sejam de teste, retorna falso.
Retornar
Boolean
: se a opção é uma resposta correta.
Autorização
Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms