פריט שאלה מוצג כרשת של עמודות ושורות שמאפשר למשיבים לבחור אפשרות אחת בכל שורה מתוך רצף של לחצני בחירה. אפשר לגשת לפריטים או ליצור אותם דרך Form
.
// Open a form by ID and add a new grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addGridItem(); item.setTitle('Rate your interests') .setRows(['Cars', 'Computers', 'Celebrities']) .setColumns(['Boring', 'So-so', 'Interesting']);
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
clearValidation() | GridItem | מסירה כל אימות נתונים עבור פריט הרשת הזה. |
createResponse(responses) | ItemResponse | יצירת ItemResponse חדש לפריט הזה ברשת. |
duplicate() | GridItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
getColumns() | String[] | הפונקציה מקבלת את הערכים של כל עמודה ברשת. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס. |
getRows() | String[] | הפונקציה מקבלת את הערכים של כל שורה ברשת. |
getTitle() | String | הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType . |
isRequired() | Boolean | הגדרה זו קובעת אם המשיב חייב לענות על השאלה. |
setColumns(columns) | GridItem | מגדירה את העמודות ברשת לפי מערך של ערכים. |
setHelpText(text) | GridItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setRequired(enabled) | GridItem | קובעת אם המשיב חייב לענות על השאלה. |
setRows(rows) | GridItem | מגדירה את השורות ברשת לפי מערך של ערכים. |
setTitle(title) | GridItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
setValidation(validation) | GridItem | מגדיר את אימות הנתונים של פריט הרשת הזה. |
תיעוד מפורט
clearValidation()
createResponse(responses)
יצירת ItemResponse
חדש לפריט הזה ברשת. הארגומנט responses
חייב להיות מערך String[]
שמכיל את מספר השורות ברשת. רכיב null
לשאלת רשת שאינה נדרשת מציין שאין תגובה לשורה הזו. הפונקציה מחריגה
חריג אם אחד מהערכים לא תואם לבחירה תקינה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
responses | String[] | מערך של תשובות תקינות לפריט הזה ברשת |
החזרות
ItemResponse
– התגובה של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
getColumns()
הפונקציה מקבלת את הערכים של כל עמודה ברשת.
החזרות
String[]
- מערך של ערכי עמודות, שהמשיבים רואים כתוויות בעת הצגת הטופס
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
getRows()
הפונקציה מקבלת את הערכים של כל שורה ברשת.
החזרות
String[]
- מערך של ערכי שורה, שהמשיבים רואים כתוויות בעת הצגת הטופס
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
setColumns(columns)
מגדירה את העמודות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
columns | String[] | מערך של ערכי עמודות, שאותם המשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
GridItem
– הפריט הזה לשרשור
קליעות
Error
– אם המערך הנתון הוא null
או שהוא ריק
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
GridItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
מגדירה את השורות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
rows | String[] | מערך של ערכי שורה, שהמשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
GridItem
– הפריט הזה לשרשור
קליעות
Error
– אם המערך הנתון הוא null
או שהוא ריק
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים של פריט הרשת הזה. העברת ערך null או תיקוף ללא פונקציות נדרשות תגרום להסרת כל האימותים הקודמים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
validation | GridValidation | רכיב GridValidation שיש להחיל על הפריט. |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms