דף זה תורגם על ידי 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`	המשוב החדש. ערך ריק ינקה את המשוב.

הלוך ושוב

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