שאלה שמאפשרת למשיב להזין גוש טקסט. אפשר לגשת לפריטים או ליצור אותם מתוך Form. כשמשתמשים בפריטים האלה בחידון, הם מקבלים ציון.
// Open a form by ID and add a new paragraph text item. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addParagraphTextItem(); item.setTitle('What is your address?');
Methods
| שיטה | סוג הערך שמוחזר | תיאור קצר |
|---|---|---|
clear | Paragraph | הסרת כל אימות נתונים לפריט הטקסט של הפסקה. |
create | Item | יוצרת Item חדש לפריט הטקסט של הפסקה הזו. |
duplicate() | Paragraph | יוצר עותק של הפריט ומצרף אותו לסוף הטופס. |
get | Quiz | הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם משיבים על שאלה שניתן לתת עליה ציון. |
get | String | מחזירה את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו Image, Page ו-Section). |
get | Integer | מחזירה את המזהה הייחודי של הפריט. |
get | Integer | מחזירה את האינדקס של הפריט מבין כל הפריטים בטופס. |
get | Integer | הפונקציה מחזירה את סה"כ הניקוד לפריט שאפשר לתת לו ציון. |
get | String | מחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של Section). |
get | Item | מחזירה את סוג הפריט, שמיוצג כ-Item. |
is | Boolean | קובעת אם המשיב חייב לענות על השאלה. |
set | Paragraph | מגדיר את המשוב שיוצג למשיבים כשהם משיבים על שאלה שניתן לתת עליה ציון ושאין לה תשובה נכונה או לא נכונה (כלומר, שאלות שנדרש לגביהן ציון ידני). |
set | Paragraph | המאפיין מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו Image, Page ו-Section). |
set | Paragraph | הגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון. |
set | Paragraph | הגדרה שקובעת אם המשיב חייב לענות על השאלה. |
set | Paragraph | הגדרת שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של Section). |
set | Paragraph | מגדירה את אימות הנתונים עבור פריט הטקסט של הפסקה. |
תיעוד מפורט
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|null – המשוב, אם יש כזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
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 | Quiz | המשוב החדש |
חזרה
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 או של מופע ParagraphTextValidation שלא הופעלו בו פונקציות require, מסירה את כל האימות הקודם.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
validation | Paragraph | ParagraphTextValidation כדי להחיל על הפריט הזה. |
חזרה
ParagraphTextItem — ParagraphTextItem הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms