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.
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());
}
Yöntemler
| Yöntem | Dönüş türü | Kısa açıklama |
|---|---|---|
getGotoPage() | PageBreakItem | Katılımcı bu seçeneği belirler ve geçerli sayfayı tamamlarsa PageBreakItem öğesini GO_TO_PAGE hedefi olarak ayarlar. |
getPageNavigationType() | PageNavigationType | Katılımcının bu seçeneği belirleyip geçerli sayfayı tamamlaması durumunda oluşan PageNavigationType değerini alır. |
getValue() | String | Katılımcıların formu görüntülerken etiket olarak gördüğü seçimin değerini alır. |
isCorrectAnswer() | Boolean | Seçimin soru için doğru cevap olup olmadığını gösterir. |
Ayrıntılı belgeler
getGotoPage()
Katılımcı bu seçeneği belirler ve geçerli sayfayı tamamlarsa PageBreakItem öğesini GO_TO_PAGE hedefi olarak ayarlar. Bu yöntem yalnızca MultipleChoiceItems ile ilişkili seçimler için geçerlidir; diğer seçenekler için null değerini döndürür.
Return
PageBreakItem — bu seçenek için GO_TO_PAGE hedefi veya hiç yoksa null
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
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ı, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
isCorrectAnswer()
Seçimin soru için doğru cevap olup olmadığını gösterir. Bu yöntem yalnızca bir testin parçası olan sorular için geçerlidir; test olmayan formlar için "false" değerini döndürür.
Return
Boolean — Seçimin doğru cevap olup olmadığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms