Class ListItem

ListItem

פריט שאלה שמאפשר למשיב לבחור תשובה אחת מתוך רשימה נפתחת. אפשר לגשת לפריטים או ליצור אותם מתוך Form. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?').setChoices([
  item.createChoice('Cats'), item.createChoice('Dogs')
]);

Methods

שיטהסוג הערך שמוחזרתיאור קצר
createChoice(value)Choiceיצירת בחירה חדשה.
createChoice(value, isCorrect)Choiceיצירת בחירה חדשה.
createChoice(value, navigationItem)Choiceיוצר בחירה חדשה עם אפשרות ניווט לדף שקופצת לפריט מסוים של מעבר דף.
createChoice(value, navigationType)Choiceיוצר בחירה חדשה עם אפשרות ניווט בדף.
createResponse(response)ItemResponseיוצרת אובייקט ItemResponse חדש עבור פריט הרשימה הזה.
duplicate()ListItemיוצר עותק של הפריט ומצרף אותו לסוף הטופס.
getChoices()Choice[]מקבל את כל האפשרויות של פריט.
getFeedbackForCorrect()QuizFeedback|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים נכון על שאלה.
getFeedbackForIncorrect()QuizFeedback|nullמחזירה את המשוב שמוצג למשיבים כשהם עונים על שאלה בצורה לא נכונה.
getHelpText()Stringמחזירה את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, ‏PageBreakItems ו-SectionHeaderItems).
getId()Integerמחזירה את המזהה הייחודי של הפריט.
getIndex()Integerמחזירה את האינדקס של הפריט מבין כל הפריטים בטופס.
getPoints()Integerהפונקציה מחזירה את סה"כ הניקוד לפריט שאפשר לתת לו ציון.
getTitle()Stringמחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).
getType()ItemTypeמחזירה את סוג הפריט, שמיוצג כ-ItemType.
isRequired()Booleanקובעת אם המשיב חייב לענות על השאלה.
setChoiceValues(values)ListItemמגדירה את האפשרויות לפריט ממערך של מחרוזות.
setChoices(choices)ListItemהגדרת מערך של אפשרויות לפריט.
setFeedbackForCorrect(feedback)ListItemהגדרת המשוב שיוצג למשיבים כשהם עונים נכון על שאלה.
setFeedbackForIncorrect(feedback)ListItemהגדרת המשוב שיוצג למשיבים אם הם ישיבו בצורה לא נכונה על שאלה.
setHelpText(text)ListItemהמאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).
setPoints(points)ListItemהגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון.
setRequired(enabled)ListItemהגדרה שקובעת אם המשיב חייב לענות על השאלה.
setTitle(title)ListItemהגדרת שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).

תיעוד מפורט

createChoice(value)

יצירת בחירה חדשה.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס

חזרה

Choice – הבחירה החדשה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

createChoice(value, isCorrect)

יצירת בחירה חדשה.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
isCorrectBooleanאם הבחירה היא תשובה נכונה

חזרה

Choice – הבחירה החדשה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

createChoice(value, navigationItem)

יוצר בחירה חדשה עם אפשרות ניווט לדף שקופצת לפריט מסוים של מעבר דף. הפונקציה הזו שוות ערך לפונקציה createChoice(value, navigationType) עם הארגומנט navigationType שמוגדר כ-FormApp.PageNavigationType.GO_TO_PAGE. אי אפשר לשלב באותו פריט בחירות שמשתמשות בניווט בין דפים עם בחירות שלא משתמשות בניווט בין דפים.

המעבר לדף הבא מתרחש אחרי שהמשיב משלים דף שמכיל את האפשרות, ורק אם המשיב בחר באפשרות הזו. אם המשיב בחר כמה אפשרויות עם הוראות ניווט בדף באותו דף, רק לאפשרות הניווט האחרונה תהיה השפעה. גם ניווט בדף לא משפיע על הדף האחרון בטופס.

שימו לב: כשמשתמשים בניווט בדף של פריט, הניתוב מוטמע בקוד, ולכן לא מומלץ להשתמש ב-showOtherOption(true) במקביל.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
navigationItemPageBreakItemהפריט שאליו רוצים לנווט

חזרה

Choice – הבחירה החדשה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

createChoice(value, navigationType)

יוצר בחירה חדשה עם אפשרות ניווט בדף. אי אפשר לשלב באותו פריט בחירות שמשתמשות בניווט בין דפים עם בחירות שלא משתמשות בניווט בין דפים.

המעבר לדף הבא מתרחש אחרי שהמשיב משלים דף שמכיל את האפשרות, ורק אם המשיב בחר באפשרות הזו. אם המשיב בחר כמה אפשרויות עם הוראות ניווט בדף באותו דף, רק לאפשרות הניווט האחרונה תהיה השפעה. גם ניווט בדף לא משפיע על הדף האחרון בטופס.

שימו לב: כשמשתמשים בניווט בדף של פריט, הניתוב מוטמע בקוד, ולכן לא מומלץ להשתמש ב-showOtherOption(true) במקביל.

פרמטרים

שםסוגתיאור
valueStringהערך של הבחירה, שהמשיבים רואים כתווית כשהם צופים בטופס
navigationTypePageNavigationTypeסוג הניווט של הבחירה

חזרה

Choice – הבחירה החדשה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

createResponse(response)

יוצרת אובייקט ItemResponse חדש עבור פריט הרשימה הזה. מוחזרת חריגה אם הארגומנט response לא תואם לבחירה חוקית עבור הפריט הזה.

פרמטרים

שםסוגתיאור
responseStringתשובה תקפה לפריט הזה ברשימה

חזרה

‫ItemResponse – התשובה לפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

duplicate()

יוצר עותק של הפריט ומצרף אותו לסוף הטופס.

חזרה

‫ListItem – עותק משוכפל של ListItem, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getChoices()

מקבל את כל האפשרויות של פריט.

חזרה

‫Choice[] — מגוון אפשרויות

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getFeedbackForCorrect()

מחזירה את המשוב שמוצג למשיבים כשהם עונים נכון על שאלה.

חזרה

‫QuizFeedback|null – המשוב, אם יש כזה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getFeedbackForIncorrect()

מחזירה את המשוב שמוצג למשיבים כשהם עונים על שאלה בצורה לא נכונה.

חזרה

‫QuizFeedback|null – המשוב, אם יש כזה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getHelpText()

מחזירה את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, ‏PageBreakItems ו-SectionHeaderItems).

חזרה

String — טקסט העזרה או טקסט התיאור של הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getId()

מחזירה את המזהה הייחודי של הפריט.

חזרה

‫Integer — המזהה של הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getIndex()

מחזירה את האינדקס של הפריט מבין כל הפריטים בטופס.

חזרה

‫Integer – האינדקס של הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getPoints()

הפונקציה מחזירה את סה"כ הניקוד לפריט שאפשר לתת לו ציון.

חזרה

‫Integer – מספר הנקודות ששווה תשובה נכונה לשאלה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getTitle()

מחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).

חזרה

‫String – שם הפריט או טקסט הכותרת

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getType()

מחזירה את סוג הפריט, שמיוצג כ-ItemType.

חזרה

‫ItemType – סוג הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

isRequired()

קובעת אם המשיב חייב לענות על השאלה.

חזרה

‫Boolean – האם המשיב חייב לענות על השאלה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setChoiceValues(values)

מגדירה את האפשרויות לפריט ממערך של מחרוזות. הפונקציה זורקת חריגה אם המערך הנתון ריק. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

פרמטרים

שםסוגתיאור
valuesString[]מערך של ערכי בחירה, שהמשיבים רואים כתוויות כשהם צופים בטופס

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setChoices(choices)

הגדרת מערך של אפשרויות לפריט. הפונקציה יוצרת חריגה אם המערך הנתון ריק או מכיל רכיב null. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

פרמטרים

שםסוגתיאור
choicesChoice[]מערך של אפשרויות

חזרה

‫ListItem — ListItem הזה, לשרשור

מקפיצה את הודעות השגיאה (Throws)

‫Error – אם המערך הנתון הוא null, ריק או מכיל רכיב null

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setFeedbackForCorrect(feedback)

הגדרת המשוב שיוצג למשיבים כשהם עונים נכון על שאלה. 

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setText('Dogs rule, cats drool.').build(),
);

פרמטרים

שםסוגתיאור
feedbackQuizFeedbackהמשוב החדש. ערך null ינקה את המשוב.

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setFeedbackForIncorrect(feedback)

הגדרת המשוב שיוצג למשיבים אם הם ישיבו בצורה לא נכונה על שאלה.

פרמטרים

שםסוגתיאור
feedbackQuizFeedbackהמשוב החדש

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setHelpText(text)

המאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).

פרמטרים

שםסוגתיאור
textStringטקסט העזרה החדש

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setPoints(points)

הגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון. ברירת המחדל לפריטים חדשים היא 0.

פרמטרים

שםסוגתיאור
pointsIntegerמספר הנקודות שכל פריט שאלה שווה

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setRequired(enabled)

הגדרה שקובעת אם המשיב חייב לענות על השאלה.

פרמטרים

שםסוגתיאור
enabledBooleanהאם המשיב חייב לענות על השאלה

חזרה

‫ListItem — הפריט הנוכחי (לשרשור)

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

setTitle(title)

הגדרת שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של SectionHeaderItem).

פרמטרים

שםסוגתיאור
titleStringהטקסט החדש של הכותרת או הכותרת הראשית

חזרה

‫ListItem — ListItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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