Class Choice

Escolha

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étodoTipo de retornoBreve descrição
getGotoPage()PageBreakItemAcessa o PageBreakItem definido como um destino de GO_TO_PAGE se o participante selecionar essa opção e concluir a página atual.
getPageNavigationType()PageNavigationTypeRecebe o PageNavigationType que ocorre se o participante selecionar essa opção e concluir a página atual.
getValue()StringRecebe o valor da escolha, que os participantes veem como um rótulo ao visualizar o formulário.
isCorrectAnswer()BooleanDefine 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

getPageNavigationType()

Recebe o PageNavigationType que ocorre se o participante selecionar essa opção e concluir a página atual. Esse método se aplica apenas a opções associadas a MultipleChoiceItems. Para outras opções, ele retorna null.

Retornar

PageNavigationType: a ação de navegação para essa escolha ou null se não houver nenhuma

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