Class GridItem

פריטברשת

פריט שאלה שמוצג כרשת של עמודות ושורות, שמאפשר למשיב לבחור תשובה אחת לכל שורה מתוך רצף של לחצני בחירה. אפשר לגשת לפריטים או ליצור אותם מתוך Form.

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Methods

שיטה	סוג הערך שמוחזר	תיאור קצר
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()

מסיר את אימות הנתונים של פריט הרשת הזה.

חזרה

‫GridItem — הפריט הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• 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()

יוצר עותק של הפריט ומצרף אותו לסוף הטופס.

חזרה

‫GridItem — עותק משוכפל של GridItem, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• 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[]	מערך של ערכי עמודות, שהמשיבים רואים כתוויות כשהם צופים בטופס

חזרה

‫GridItem — הפריט הזה, לשרשור

זריקות

‫Error – אם המערך הנתון הוא null או ריק

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setHelpText(text)

מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט התיאור של פריטי פריסה כמו ImageItems, PageBreakItems ו-SectionHeaderItems).

פרמטרים

שם	סוג	תיאור
text	String	טקסט העזרה החדש

חזרה

‫GridItem — ‏GridItem, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• 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	הטקסט החדש של הכותרת או הכותרת הראשית

חזרה

‫GridItem — GridItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setValidation(validation)

מגדירה את אימות הנתונים של פריט הרשת הזה. העברה של null או של מופע GridValidation שלא הופעלו בו פונקציות require, מסירה את כל האימות הקודם.

פרמטרים

שם	סוג	תיאור
validation	GridValidation	‫GridValidation שיש להחיל על הפריט הזה.

חזרה

‫GridItem — GridItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms