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

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

החזרות

TextItemTextItem, לשרשור

הרשאות

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

  • 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המשוב החדש

החזרות

TextItemTextItem, לשרשור

הרשאות

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

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

setHelpText(text)

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

פרמטרים

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

החזרות

TextItemTextItem, לשרשור

הרשאות

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

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

setPoints(points)

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

פרמטרים

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

החזרות

TextItemTextItem, לשרשור

הרשאות

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

  • 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הכותרת או הטקסט של הכותרת החדשה

החזרות

TextItemTextItem, לשרשור

הרשאות

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

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

setValidation(validation)

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

פרמטרים

שםתיאורהתיאור
validationTextValidationבדיקת TextValidation שתחול על הפריט הזה.

החזרות

TextItemTextItem, לשרשור

הרשאות

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

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