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()PageBreakItemRecebe o PageBreakItem definido como um destino GO_TO_PAGE. se o participante selecionar essa opção e completar a página atual.
getPageNavigationType()PageNavigationTypeRecebe o PageNavigationType que ocorre se o participante selecionar essa opção e conclui a página atual.
getValue()StringExtrai o valor da opção, que os entrevistados veem como um marcador ao visualizar o formulário.
isCorrectAnswer()BooleanDescobre 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

getPageNavigationType()

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

Retornar

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

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