Class ParagraphTextItem

ParagraphTextItem

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

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

שיטות

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

תיעוד מפורט

clearValidation()

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

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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

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

החזרות

ParagraphTextItem – עותק משוכפל של ParagraphTextItem, לשרשור

הרשאות

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

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

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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

setHelpText(text)

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

פרמטרים

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

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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

setPoints(points)

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

פרמטרים

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

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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

setRequired(enabled)

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

פרמטרים

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

החזרות

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

הרשאות

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

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

setTitle(title)

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

פרמטרים

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

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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

setValidation(validation)

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

פרמטרים

שםתיאורהתיאור
validationParagraphTextValidationa ParagraphTextValidation שיש להחיל על פריט זה.

החזרות

ParagraphTextItemParagraphTextItem, לשרשור

הרשאות

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

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