פריט שאלה שמאפשר למשיב להזין בלוק טקסט. אפשר לגשת לפריטים או ליצור אותם מתוך 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()
הסרת אימות הנתונים של פריט הטקסט בפסקה.
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
createResponse(response)
יוצר Item חדש לפריט הטקסט של הפסקה הזו.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
response | String | תשובה לשאלה שמופיעה בפריט |
חזרה
Item – התשובה לפריט
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
duplicate()
יוצר עותק של הפריט ומצרף אותו לסוף הטופס.
חזרה
Paragraph — עותק משוכפל של Paragraph, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGeneralFeedback()
הפונקציה מחזירה את המשוב שמוצג למשיבים כשהם משיבים על שאלה שאפשר לתת עליה ציון.
חזרה
Quiz – המשוב, אם יש כזה.
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
מקבל את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטים בפריסה כמו Image, Page ו-Section).
חזרה
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()
מחזירה את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של Section).
חזרה
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 | המשוב החדש |
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטי פריסה כמו Image, Page ו-Section).
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
text | String | טקסט העזרה החדש |
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setPoints(points)
הגדרת מספר הנקודות ששווה פריט שאפשר לתת לו ציון. ערך ברירת המחדל של פריטים חדשים הוא 0.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
points | Integer | מספר הנקודות ששווה פריט שאלה |
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setRequired(enabled)
הגדרה שקובעת אם המשיב חייב לענות על השאלה.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
חזרה
Paragraph — הפריט הנוכחי (לשרשור)
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את שם הפריט (לפעמים נקרא טקסט הכותרת, במקרה של Section).
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
title | String | הטקסט החדש של הכותרת או הכותרת הראשית |
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים עבור פריט הטקסט של הפסקה הזו. העברה של null או של מופע Paragraph שלא הופעלו בו פונקציות require, מסירה את כל האימות הקודם.
פרמטרים
| שם | סוג | תיאור |
|---|---|---|
validation | Paragraph | ParagraphTextValidation שיחול על הפריט הזה. |
חזרה
Paragraph — Paragraph הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms