Class Choice

Escolha

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

---

getPageNavigationType()

Recebe a PageNavigationType que ocorre se o respondente 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, ele retorna null.

Retorno

PageNavigationType: a ação de navegação dessa opção 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 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