Class Choice

Choice

Satu pilihan yang terkait dengan jenis Item yang mendukung pilihan, seperti CheckboxItem, ListItem, atau 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(),
  );
}

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getGotoPage()PageBreakItemMendapatkan PageBreakItem yang ditetapkan sebagai tujuan GO_TO_PAGE jika responden memilih pilihan ini dan menyelesaikan halaman saat ini.
getPageNavigationType()PageNavigationTypeMendapatkan PageNavigationType yang terjadi jika responden memilih pilihan ini dan menyelesaikan halaman saat ini.
getValue()StringMendapatkan nilai pilihan, yang dilihat responden sebagai label saat melihat formulir.
isCorrectAnswer()BooleanMendapatkan apakah pilihan merupakan jawaban yang benar untuk pertanyaan.

Dokumentasi mendetail

getGotoPage()

Mendapatkan PageBreakItem yang ditetapkan sebagai tujuan GO_TO_PAGE jika responden memilih pilihan ini dan menyelesaikan halaman saat ini. Metode ini hanya berlaku untuk pilihan yang terkait dengan MultipleChoiceItems; untuk pilihan lain, metode ini akan menampilkan null.

Pulang pergi

PageBreakItem — tujuan GO_TO_PAGE untuk pilihan ini, atau null jika tidak ada

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPageNavigationType()

Mendapatkan PageNavigationType yang terjadi jika responden memilih pilihan ini dan menyelesaikan halaman saat ini. Metode ini hanya berlaku untuk pilihan yang terkait dengan MultipleChoiceItems; untuk pilihan lain, metode ini akan menampilkan null.

Pulang pergi

PageNavigationType — tindakan navigasi untuk pilihan ini, atau null jika tidak ada

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getValue()

Mendapatkan nilai pilihan, yang dilihat responden sebagai label saat melihat formulir.

Pulang pergi

String — nilai pilihan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

isCorrectAnswer()

Mendapatkan apakah pilihan merupakan jawaban yang benar untuk pertanyaan. Metode ini hanya berlaku untuk pertanyaan yang merupakan bagian dari kuis; untuk formulir non-kuis, metode ini akan menampilkan nilai salah.

Pulang pergi

Boolean — Apakah pilihan tersebut merupakan jawaban yang benar.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms