מאפשר לסקריפט לפתוח Form
קיים או ליצור סקריפט חדש.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
תכונות
נכס | תיאור | התיאור |
---|---|---|
Alignment | Alignment | ספירה של סוגים של יישור תמונה. |
DestinationType | DestinationType | ספירה של סוגי יעדים שבהם אפשר לשמור תשובות לטופס. |
FeedbackType | FeedbackType | ספירה של סוגי הטופס Feedbacks . |
ItemType | ItemType | ספירה של סוגי הטופס Items . |
PageNavigationType | PageNavigationType | רשימת התנהגויות אפשריות לניווט בדפים. |
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
create(title) | Form | יצירה ומחזירה של Form חדש. |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | הפונקציה מחזירה מופע של CheckboxGridValidationBuilder שאפשר להשתמש בו כדי להגדיר את האימות ב-CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | הפונקציה מחזירה מופע של CheckboxValidationBuilder שאפשר להשתמש בו כדי להגדיר אימות ב-CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | הפונקציה מחזירה מופע של QuizFeedbackBuilder, שניתן להשתמש בו כדי להגדיר משוב על Item שניתן לתת לו ציון. |
createGridValidation() | GridValidationBuilder | מחזירה מופע של GridValidationBuilder שיכול לשמש להגדרת אימות ב-GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | הפונקציה מחזירה מופע של ParagraphTextValidationBuilder שאפשר להשתמש בו כדי להגדיר את האימות ב-ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | מחזירה מופע של TextValidationBuilder שניתן להשתמש בו כדי להגדיר אימות ב-TextItem . |
getActiveForm() | Form | מחזירה את הצורה שאליה הסקריפט מקושר לקונטיינר. |
getUi() | Ui | מחזירה מופע של סביבת ממשק המשתמש של עורך הטפסים, שמאפשר לסקריפט להוסיף תכונות כמו תפריטים, תיבות דו-שיח וסרגלי צד. |
openById(id) | Form | הפונקציה מחזירה את הערך Form עם המזהה שצוין. |
openByUrl(url) | Form | הפונקציה מחזירה את הערך Form עם כתובת ה-URL שצוינה. |
תיעוד מפורט
create(title)
יצירה ומחזירה של Form
חדש. הפונקציה מוסיפה החרגה אם שם הפריט הוא null
או שהוא ריק.
// Create and open a form. var form = FormApp.create('Form Name');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | שם הטופס החדש |
החזרות
Form
– הטופס החדש
קליעות
Error
— אם שם הפריט הוא null
או שהוא ריק
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
הפונקציה מחזירה מופע של CheckboxGridValidationBuilder שאפשר להשתמש בו כדי להגדיר את האימות ב-CheckboxGridItem
.
החזרות
createCheckboxValidation()
הפונקציה מחזירה מופע של CheckboxValidationBuilder שאפשר להשתמש בו כדי להגדיר אימות ב-CheckboxItem
.
החזרות
createFeedback()
הפונקציה מחזירה מופע של QuizFeedbackBuilder, שניתן להשתמש בו כדי להגדיר משוב על Item
שניתן לתת לו ציון.
החזרות
createGridValidation()
מחזירה מופע של GridValidationBuilder שיכול לשמש להגדרת אימות ב-GridItem
.
החזרות
createParagraphTextValidation()
הפונקציה מחזירה מופע של ParagraphTextValidationBuilder שאפשר להשתמש בו כדי להגדיר את האימות ב-ParagraphTextItem
.
החזרות
createTextValidation()
מחזירה מופע של TextValidationBuilder שניתן להשתמש בו כדי להגדיר אימות ב-TextItem
.
החזרות
getActiveForm()
מחזירה את הצורה שאליה הסקריפט מקושר לקונטיינר. כדי לבצע אינטראקציה עם טפסים שבהם הסקריפט לא מקושר לקונטיינר, צריך להשתמש במקום זאת ב-openById(id)
או ב-openByUrl(url)
.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
החזרות
Form
– הטופס שאליו הסקריפט מקושר, או null
אם הסקריפט לא מקושר
לטופס
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
מחזירה מופע של סביבת ממשק המשתמש של עורך הטפסים, שמאפשר לסקריפט להוסיף תכונות כמו תפריטים, תיבות דו-שיח וסרגלי צד. סקריפט יכול לבצע אינטראקציה עם ממשק המשתמש רק במופע הנוכחי של עורך טפסים פתוח (ולא בתצוגה שהמשיבים רואים), ורק אם הסקריפט מקושר לטופס. מידע נוסף זמין במדריכים לתפריטים ולתיבות דו-שיח וסרגלי צד.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
החזרות
Ui
– מופע של סביבת ממשק המשתמש של הטופס הזה
openById(id)
הפונקציה מחזירה את הערך Form
עם המזהה שצוין. הקוד הזה מכניס החרגה אם המזהה לא תקין או שלמשתמש אין הרשאה לפתוח את הטופס.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
פרמטרים
שם | תיאור | התיאור |
---|---|---|
id | String | המזהה של הטופס שצריך לפתוח |
החזרות
Form
- הטופס עם המזהה הנתון
קליעות
Error
– אם המזהה הנתון לא חוקי או שלמשתמש אין מספיק הרשאות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
הפונקציה מחזירה את הערך Form
עם כתובת ה-URL שצוינה. הקוד הזה מציג חריגות במקרים שבהם כתובת ה-URL לא תקינה או שלמשתמש אין הרשאה לפתוח את הטופס.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
פרמטרים
שם | תיאור | התיאור |
---|---|---|
url | String | כתובת ה-URL של הטופס שצריך לפתוח |
החזרות
Form
- הטופס עם כתובת האתר הנתונה
קליעות
Error
– אם כתובת ה-URL שצוינה לא חוקית או שלמשתמש אין מספיק הרשאות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms