Class TextItem

TextItem

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

// Open a form by ID and add a new text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addTextItem();
item.setTitle('What is your name?');

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
clearValidation()	TextItem	הסרת כל אימות הנתונים של פריט הטקסט הזה.
createResponse(response)	ItemResponse	יצירת ItemResponse חדש לפריט הטקסט הזה.
duplicate()	TextItem	יצירת עותק של הפריט הזה והוספתו לסוף הטופס.
getGeneralFeedback()	QuizFeedback	הפונקציה מחזירה את המשוב שמוצג לתלמידים כשהם משיבים לשאלה שניתנת למתן ציונים.
getHelpText()	String	הפונקציה מקבלת את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).
getId()	Integer	הפונקציה מקבלת את המזהה הייחודי של הפריט.
getIndex()	Integer	הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס.
getPoints()	Integer	הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת עליו ציון.
getTitle()	String	הפונקציה מקבלת את שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).
getType()	ItemType	הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType.
isRequired()	Boolean	קובע אם המשיב חייב לענות על השאלה.
setGeneralFeedback(feedback)	TextItem	מגדיר את המשוב שיוצג למשתתפים כשהם משיבים לשאלה שניתנת למתן ציונים, שאין לה תשובה נכונה או שגויה (כלומר, שאינה ניתנת למתן ציונים אוטומטי).
setHelpText(text)	TextItem	מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).
setPoints(points)	TextItem	הגדרת מספר הנקודות שפריט שניתן להגיש עליו מטלה שווה.
setRequired(enabled)	TextItem	מגדיר אם המשיב חייב לענות על השאלה.
setTitle(title)	TextItem	הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).
setValidation(validation)	TextItem	מגדיר את אימות הנתונים של פריט הטקסט הזה.

מסמכים מפורטים

clearValidation()

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

חזרה

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

אישור

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

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

---

createResponse(response)

יצירת ItemResponse חדש לפריט הטקסט הזה.

פרמטרים

שם	סוג	תיאור
response	String	תשובה לשאלה שמופיעה בפריט

חזרה

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

אישור

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

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

---

duplicate()

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

חזרה

TextItem – עותק כפול של TextItem הזה, לצורך שרשור

אישור

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

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

---

getGeneralFeedback()

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

חזרה

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

---

setGeneralFeedback(feedback)

מגדיר את המשוב שיוצג למשתתפים כשהם משיבים לשאלה שניתנת למתן ציונים, שאין לה תשובה נכונה או שגויה (כלומר, שאינה ניתנת למתן ציונים אוטומטי).

פרמטרים

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

חזרה

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

אישור

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

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

---

setHelpText(text)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setPoints(points)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setRequired(enabled)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setTitle(title)

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

פרמטרים

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

חזרה

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

אישור

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

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

---

setValidation(validation)

מגדיר את אימות הנתונים של פריט הטקסט הזה. העברה של null או של אימות ללא קריאה לפונקציות require תגרום להסרת כל אימות קודם.

פרמטרים

שם	סוג	תיאור
validation	TextValidation	בדיקת תקינות טקסט שתחול על הפריט הזה.

חזרה

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

אישור

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

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