דף זה תורגם על ידי Cloud Translation API.

Class DateItem

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

// Open a form by ID and add a new date item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addDateItem();
item.setTitle('When were you born?');

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`createResponse(response)`	`ItemResponse`	יצירת `ItemResponse` חדש לפריט התאריך הזה.
`duplicate()`	`DateItem`	יצירת עותק של הפריט הזה וצירוף שלו לסוף הטופס.
`getGeneralFeedback()`	`QuizFeedback`	החזרה של המשוב שמוצג למשיבים כשהם משיבים לשאלה שניתן לדרג.
`getHelpText()`	`String`	קבלת טקסט עזרה של הפריט (שנקרא לפעמים טקסט תיאור של פריטי פריסה כמו `ImageItems`, `PageBreakItems` ו`SectionHeaderItems`).
`getId()`	`Integer`	מקבל את המזהה הייחודי של הפריט.
`getIndex()`	`Integer`	קבלת האינדקס של הפריט בין כל הפריטים בטופס.
`getPoints()`	`Integer`	מחזירה את ערך הנקודות של פריט הניתן לדירוג.
`getTitle()`	`String`	מקבל את הפריט של הפריט (נקרא לפעמים טקסט כותרת, במקרה של `SectionHeaderItem`).
`getType()`	`ItemType`	מזהה את סוג הפריט, מיוצג כ-`ItemType`.
`includesYear()`	`Boolean`	האפשרות הזו קובעת אם פריט התאריך כולל אפשרות לשנה.
`isRequired()`	`Boolean`	קובעת אם המשיב צריך לענות על השאלה.
`setGeneralFeedback(feedback)`	`DateItem`	מגדיר את המשוב שיוצג למשיבים כשהם יענו על שאלה בעלת ציון או שאין לה תשובה נכונה או שגויה (למשל, שאלות שדורשות ציון ידני).
`setHelpText(text)`	`DateItem`	מגדיר את טקסט העזרה של הפריט (הנקרא לפעמים טקסט תיאור עבור פריטי פריסה כמו `ImageItems`, `PageBreakItems` ו`SectionHeaderItems`).
`setIncludesYear(enableYear)`	`DateItem`	קובעת אם פריט התאריך כולל הגדרה של שנה.
`setPoints(points)`	`DateItem`	מגדירה את מספר הנקודות שפריט הניתן לדירוג שווה לו.
`setRequired(enabled)`	`DateItem`	הגדרה אם המשיב חייב לענות על השאלה.
`setTitle(title)`	`DateItem`	מגדיר את הכותרת של הפריט (שנקראת לפעמים טקסט כותרת, במקרה של `SectionHeaderItem`).

תיעוד מפורט

`createResponse(response)`

יצירת ItemResponse חדש לפריט התאריך הזה. המערכת מתעלמת משדות הזמן של האובייקט Date; כברירת מחדל, המערכת משתמשת רק בשדות 'שנה', 'חודש' ו'יום'. אם המאפיין setIncludesYear(enabled) מוגדר ל-false, המערכת תתעלם גם מהשנה.

פרמטרים

שם	סוג	תיאור
`response`	`Date`	אובייקט `Date` שמייצג חודש, יום ואולי שנה

הלוך ושוב

ItemResponse — התגובה של הפריט

הרשאה

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

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

`duplicate()`

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

הלוך ושוב

DateItem — עותק משוכפל של DateItem זה, לשרשור

הרשאה

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

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

`getGeneralFeedback()`

החזרה של המשוב שמוצג למשיבים כשהם משיבים לשאלה שניתן לדרג.

הלוך ושוב

QuizFeedback — המשוב, אם יש.

הרשאה

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

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

`getPoints()`

מחזירה את ערך הנקודות של פריט הניתן לדירוג.

הלוך ושוב

Integer — מספר הנקודות תמורת שאלה.

הרשאה

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

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

`includesYear()`

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

הלוך ושוב

Boolean — true אם התאריך כולל הגדרת שנה; false אם לא

הרשאה

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

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

`setGeneralFeedback(feedback)`

מגדיר את המשוב שיוצג למשיבים כשהם יענו על שאלה בעלת ציון או שאין לה תשובה נכונה או שגויה (למשל, שאלות שדורשות ציון ידני).

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש

הלוך ושוב

DateItem — DateItem זה, לשרשור

הרשאה

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

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

`setHelpText(text)`

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

פרמטרים

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

הלוך ושוב

DateItem — DateItem זה, לשרשור

הרשאה

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

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

`setIncludesYear(enableYear)`

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

פרמטרים

שם	סוג	תיאור
`enableYear`	`Boolean`	`true` אם התאריך כולל הגדרת שנה; `false` אם לא

הלוך ושוב

DateItem — DateItem זה, לשרשור

הרשאה

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

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

`setPoints(points)`

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

פרמטרים

שם	סוג	תיאור
`points`	`Integer`	מספר הנקודות שפריט מסוים שווה

הלוך ושוב

DateItem — DateItem זה, לשרשור

הרשאה

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

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

`setRequired(enabled)`

הגדרה אם המשיב חייב לענות על השאלה.

פרמטרים

שם	סוג	תיאור
`enabled`	`Boolean`	אם המשיב חייב לענות על השאלה

הלוך ושוב

DateItem — הפריט הנוכחי (לשרשור)

הרשאה

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

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

`setTitle(title)`

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

פרמטרים

שם	סוג	תיאור
`title`	`String`	הטקסט החדש של הכותרת או הכותרת

הלוך ושוב

DateItem — DateItem זה, לשרשור

הרשאה

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

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