דף זה תורגם על ידי Cloud Translation API.

Class 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`	הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים נכון לשאלה.
`getFeedbackForIncorrect()`	`QuizFeedback`	הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים בצורה שגויה על שאלה.
`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)`

יצירת אפשרות חדשה.

פרמטרים

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

חזרה

Choice – האפשרות החדשה

אישור

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

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

`createChoice(value, isCorrect)`

יצירת אפשרות חדשה.

פרמטרים

שם	סוג	תיאור
`value`	`String`	ערך הבחירה, שמוצג למשיבים בתור תווית כשהם צופים בטופס
`isCorrect`	`Boolean`	אם הבחירה היא תשובה נכונה

חזרה

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

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

פרמטרים

שם	סוג	תיאור
`value`	`String`	ערך הבחירה, שמוצג למשיבים בתור תווית כשהם צופים בטופס
`navigationItem`	`PageBreakItem`	הפריט שאליו רוצים לנווט

חזרה

Choice – האפשרות החדשה

אישור

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

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

`createChoice(value, navigationType)`

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

פרמטרים

שם	סוג	תיאור
`value`	`String`	ערך הבחירה, שמוצג למשיבים בתור תווית כשהם צופים בטופס
`navigationType`	`PageNavigationType`	סוג הניווט של האפשרות שנבחרה

חזרה

Choice – האפשרות החדשה

אישור

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

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

`createResponse(response)`

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

פרמטרים

שם	סוג	תיאור
`response`	`String`	תשובה תקינה לפריט הרשימה הזה

חזרה

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 – המשוב, אם יש כזה.

אישור

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

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

`getFeedbackForIncorrect()`

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

חזרה

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

אישור

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

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']);

פרמטרים

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

חזרה

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')]);

פרמטרים

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

חזרה

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

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש. ערך null ימחק את המשוב.

חזרה

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

אישור

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

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

`setFeedbackForIncorrect(feedback)`

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

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש

חזרה

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

אישור

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

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

`setHelpText(text)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setPoints(points)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setRequired(enabled)`

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

פרמטרים

שם	סוג	תיאור
`enabled`	`Boolean`	אם המשיב חייב להשיב על השאלה

חזרה

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

אישור

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

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

`setTitle(title)`

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

פרמטרים

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

חזרה

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

אישור

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

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