Class Choice

Escolha

Uma única escolha associada a um tipo de Item que aceita escolhas, como CheckboxItem, ListItem ou MultipleChoiceItem.

// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const 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.
const choices = item.getChoices();
for (let 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 concluir a página atual.
getPageNavigationType()	PageNavigationType	Recebe o PageNavigationType que ocorre se o participante seleciona essa opção e conclui a página atual.
getValue()	String	Recebe o valor da opção, que os participantes veem como um rótulo ao visualizar o formulário.
isCorrectAnswer()	Boolean	Verifica se a escolha é 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 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

PageBreakItem: o destino GO_TO_PAGE dessa 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 seleciona essa opção e conclui 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 opção, 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()

Verifica se a escolha é uma resposta correta para a pergunta. Esse método se aplica apenas a perguntas que fazem parte de um teste. Para formulários que não são testes, ele retorna falso.

Retornar

Boolean: indica 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