Class TextItem

TextItem

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

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

שיטות

שיטהסוג הערך המוחזרתיאור קצר
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 חדש לפריט הטקסט הזה.

פרמטרים

שםסוגתיאור
responseStringתשובה לשאלה בפריט

חזרה

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)

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

פרמטרים

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

חזרה

TextItem – הTextItem הזה, לשרשור

אישור

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

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

setHelpText(text)

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

פרמטרים

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

חזרה

TextItem – הTextItem הזה, לשרשור

אישור

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

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

setPoints(points)

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

פרמטרים

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

חזרה

TextItem – הTextItem הזה, לשרשור

אישור

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

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

setRequired(enabled)

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

פרמטרים

שםסוגתיאור
enabledBooleanהאם המשיב חייב לענות על השאלה

חזרה

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

אישור

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

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

setTitle(title)

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

פרמטרים

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

חזרה

TextItem – הTextItem הזה, לשרשור

אישור

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

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

setValidation(validation)

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

פרמטרים

שםסוגתיאור
validationTextValidationTextverificationation (אימות טקסט) שיחול על הפריט הזה.

חזרה

TextItem – הTextItem הזה, לשרשור

אישור

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

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