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. אי אפשר לשלב באותו פריט בחירות שמשתמשות בניווט בין דפים עם בחירות שלא משתמשות בניווט בין דפים.

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

פרמטרים

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

חזרה

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

אישור

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

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

createChoice(value, navigationType)

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

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

פרמטרים

שםסוגתיאור
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 הזה, לשרשור

זריקות

‫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().setDisplayText('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