Class GridItem

GridItem

פריט שאלה מוצג כרשת של עמודות ושורות שמאפשר למשיבים לבחור אפשרות אחת בכל שורה מתוך רצף של לחצני בחירה. אפשר לגשת לפריטים או ליצור אותם דרך 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()

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

החזרות

GridItem – הפריט הזה לשרשור

הרשאות

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

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

createResponse(responses)

יצירת ItemResponse חדש לפריט הזה ברשת. הארגומנט responses חייב להיות מערך String[] שמכיל את מספר השורות ברשת. רכיב null לשאלת רשת שאינה נדרשת מציין שאין תגובה לשורה הזו. הפונקציה מחריגה חריג אם אחד מהערכים לא תואם לבחירה תקינה.

פרמטרים

שםתיאורהתיאור
responsesString[]מערך של תשובות תקינות לפריט הזה ברשת

החזרות

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)

מגדירה את העמודות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.

פרמטרים

שםתיאורהתיאור
columnsString[]מערך של ערכי עמודות, שאותם המשיבים רואים כתוויות בעת הצגת הטופס

החזרות

GridItem – הפריט הזה לשרשור

קליעות

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

הרשאות

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

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

setHelpText(text)

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

פרמטרים

שםתיאורהתיאור
textStringטקסט העזרה החדש

החזרות

GridItemGridItem, לשרשור

הרשאות

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

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

setRequired(enabled)

קובעת אם המשיב חייב לענות על השאלה.

פרמטרים

שםתיאורהתיאור
enabledBooleanהאם המשיב חייב לענות על השאלה

החזרות

GridItem – הפריט הנוכחי (לשרשור)

הרשאות

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

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

setRows(rows)

מגדירה את השורות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.

פרמטרים

שםתיאורהתיאור
rowsString[]מערך של ערכי שורה, שהמשיבים רואים כתוויות בעת הצגת הטופס

החזרות

GridItem – הפריט הזה לשרשור

קליעות

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

הרשאות

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

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

setTitle(title)

מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem).

פרמטרים

שםתיאורהתיאור
titleStringהכותרת או הטקסט של הכותרת החדשה

החזרות

GridItemGridItem, לשרשור

הרשאות

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

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

setValidation(validation)

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

פרמטרים

שםתיאורהתיאור
validationGridValidationרכיב GridValidation שיש להחיל על הפריט.

החזרות

GridItemGridItem, לשרשור

הרשאות

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

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