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

Class ListItem

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

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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