פריט שאלה, שמוצג כרשת של עמודות ושורות, ומאפשר למשיבים לבחור
אפשרויות מרובות בכל שורה מתוך רצף של תיבות סימון. אפשר לגשת לפריטים או ליצור אותם
Form
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
clearValidation() | CheckboxGridItem | הסרת כל אימות הנתונים של פריט הרשת הזה. |
createResponse(responses) | ItemResponse | יצירת ItemResponse חדש לפריט ברשת תיבות הסימון. |
duplicate() | CheckboxGridItem | יוצר עותק של הפריט הזה ומצרף אותו לסוף הטופס. |
getColumns() | String[] | הפונקציה מקבלת את הערכים של כל עמודה ברשת. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' של פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט בין כל הפריטים בטופס. |
getRows() | String[] | הפונקציה מקבלת את הערכים של כל שורה ברשת. |
getTitle() | String | הפונקציה מקבלת את שם הפריט (לפעמים נקרא 'טקסט כותרת' במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצגת באמצעות ItemType . |
isRequired() | Boolean | קובע אם המשיב/ה חייב לענות על השאלה. |
setColumns(columns) | CheckboxGridItem | מגדירה את עמודות הרשת על סמך מערך של ערכים. |
setHelpText(text) | CheckboxGridItem | מגדיר את טקסט העזרה של הפריט (לפעמים נקרא 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | ההגדרה קובעת אם המשיבים חייבים לענות על השאלה. |
setRows(rows) | CheckboxGridItem | מגדירה את שורות הרשת על סמך מערך של ערכים. |
setTitle(title) | CheckboxGridItem | מגדיר את כותרת הפריט (לפעמים נקרא 'טקסט כותרת', במקרה של SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | מגדיר את אימות הנתונים עבור פריט הרשת הזה. |
מסמכי תיעוד מפורטים
clearValidation()
הסרת כל אימות הנתונים של פריט הרשת הזה.
חזרה
CheckboxGridItem
– הפריט הזה, לשרשורים
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
יצירת ItemResponse
חדש לפריט ברשת תיבות הסימון. הארגומנט responses
חייב להיות מערך String[][]
של מערכים שמכילים ערכים כמו מספר הקלט
ברשת תיבות הסימון. רכיב null
לשאלת רשת של תיבות סימון שאינה נדרשת
מציין שאין תגובה לשורה הזו. פעולה זו גורמת לחריגה אם ערך כלשהו לא תואם
בחירה תקפה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
responses | String[][] | מערך של מערכים של תשובות חוקיות לפריט רשת זה של תיבות סימון |
חזרה
ItemResponse
– התגובה של הפריט
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
יוצר עותק של הפריט הזה ומצרף אותו לסוף הטופס.
חזרה
CheckboxGridItem
– כפילות של CheckboxGridItem
, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
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()
הפונקציה מקבלת את סוג הפריט, שמיוצגת באמצעות 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
setColumns(columns)
מגדירה את עמודות הרשת על סמך מערך של ערכים. הפעולה הזו גורמת לחריגה אם הנתון המערך ריק.
פרמטרים
שם | סוג | תיאור |
---|---|---|
columns | String[] | מערך של ערכי עמודות, שאותם המשיבים רואים כתוויות בעת צפייה בטופס |
חזרה
CheckboxGridItem
– הפריט הזה, לשרשורים
קליעות
Error
– אם המערך הנתון הוא null
או ריק
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (לפעמים נקרא 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | טקסט העזרה החדש |
חזרה
CheckboxGridItem
– הCheckboxGridItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
ההגדרה קובעת אם המשיבים חייבים לענות על השאלה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
חזרה
CheckboxGridItem
– הפריט הנוכחי (לשרשור)
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
מגדירה את שורות הרשת על סמך מערך של ערכים. פעולה זו גורמת לחריגה אם המערך הנתון ריקה.
פרמטרים
שם | סוג | תיאור |
---|---|---|
rows | String[] | מערך של ערכי שורות, שאותם המשיבים רואים כתוויות בעת צפייה בטופס |
חזרה
CheckboxGridItem
– הפריט הזה, לשרשורים
קליעות
Error
– אם המערך הנתון הוא null
או ריק
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (לפעמים נקרא 'טקסט כותרת', במקרה של SectionHeaderItem
).
פרמטרים
שם | סוג | תיאור |
---|---|---|
title | String | הטקסט של הכותרת או הכותרת החדשים |
חזרה
CheckboxGridItem
– הCheckboxGridItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים עבור פריט הרשת הזה. העברת null או אימות ללא כל פונקציות נדרשות שנקראות יוסרו כל האימות הקודם.
פרמטרים
שם | סוג | תיאור |
---|---|---|
validation | CheckboxGridValidation | CheckboxGrid Validation שיש להחיל על הפריט הזה. |
חזרה
CheckboxGridItem
– הCheckboxGridItem
הזה, לשרשור
אישור
סקריפטים שמשתמשים בשיטה הזו מחייבים הרשאה עם אחד או יותר מהיקפי ההרשאות הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms