פריט שאלה שמאפשר למשיב להזין קטע טקסט. אפשר לגשת לפריטים או ליצור פריטים באמצעות 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()
מסיר כל אימות נתונים מפריט הטקסט של הפסקה הזו.
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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()
יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס.
החזרות
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()
isRequired()
הגדרה זו קובעת אם המשיב חייב לענות על השאלה.
החזרות
Boolean
– האם המשיב חייב לענות על השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGeneralFeedback(feedback)
מגדיר את המשוב שיוצג למשיבים כשהם משיבים על שאלה שאפשר לתת לה ציון, ושאין לה תשובה נכונה או שגויה (למשל, שאלות שנדרש להן ציון ידני).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
feedback | QuizFeedback | המשוב החדש |
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות לשווי של פריט שניתן לדרג. ברירת המחדל לפריטים חדשים היא 0.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
points | Integer | את מספר הנקודות ששווה פריט שאלה מסוים |
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
ParagraphTextItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים עבור פריט הטקסט של הפסקה. העברת ערך null או תיקוף ללא פונקציות נדרשות תגרום להסרת כל האימותים הקודמים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
validation | ParagraphTextValidation | a ParagraphTextValidation שיש להחיל על פריט זה. |
החזרות
ParagraphTextItem
— ParagraphTextItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms