Class Choice

Choice

CheckboxItem, ListItem veya MultipleChoiceItem gibi seçenekleri destekleyen bir Item türüyle ilişkili tek bir seçenek.

// 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(),
  );
}

Yöntemler

YöntemDönüş türüKısa açıklama
getGotoPage()PageBreakItemKatılımcı bu seçimi yapar ve mevcut sayfayı tamamlarsa PageBreakItem'yi GO_TO_PAGE hedefi olarak ayarlar.
getPageNavigationType()PageNavigationTypeKatılımcı bu seçimi yapıp geçerli sayfayı tamamlarsa oluşan PageNavigationType değerini alır.
getValue()StringKatılımcıların formu görüntülerken etiket olarak gördüğü, seçimin değerini alır.
isCorrectAnswer()BooleanSeçeneğin soruya doğru bir yanıt olup olmadığını alır.

Ayrıntılı dokümanlar

getGotoPage()

Katılımcı bu seçimi yapar ve mevcut sayfayı tamamlarsa PageBreakItem'yi GO_TO_PAGE hedefi olarak ayarlar. Bu yöntem yalnızca MultipleChoiceItems ile ilişkili seçimler için geçerlidir; diğer seçimler için null döndürür.

Return

PageBreakItem: Bu seçimin GO_TO_PAGE hedefi veya hedef yoksa null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getPageNavigationType()

Katılımcı bu seçimi yapıp geçerli sayfayı tamamlarsa oluşan PageNavigationType değerini alır. Bu yöntem yalnızca MultipleChoiceItems ile ilişkili seçimler için geçerlidir; diğer seçimler için null döndürür.

Return

PageNavigationType: Bu seçim için gezinme işlemi veya yoksa null

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getValue()

Katılımcıların formu görüntülerken etiket olarak gördüğü, seçimin değerini alır.

Return

String: Seçimin değeri

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

isCorrectAnswer()

Seçeneğin soruya doğru bir yanıt olup olmadığını alır. Bu yöntem yalnızca testin bir parçası olan sorular için geçerlidir. Test olmayan formlar için yanlış değerini döndürür.

Return

Boolean: Seçeneğin doğru yanıt olup olmadığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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