פריט פריסה שמציג סרטון. אפשר לגשת לפריטים או ליצור אותם דרך Form
.
// Open a form by ID and add three new video items, using a long URL, // a short URL, and a video ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); form.addVideoItem() .setTitle('Video Title') .setHelpText('Video Caption') .setVideoUrl('www.youtube.com/watch?v=1234abcdxyz'); form.addVideoItem() .setTitle('Video Title') .setHelpText('Video Caption') .setVideoUrl('youtu.be/1234abcdxyz'); form.addVideoItem() .setTitle('Video Title') .setHelpText('Video Caption') .setVideoUrl('1234abcdxyz');
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
duplicate() | VideoItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
getAlignment() | Alignment | העמודה הזו מאפשרת לראות את היישור האופקי של הסרטון. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס. |
getTitle() | String | הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType . |
getWidth() | Integer | הפונקציה מקבלת את רוחב הסרטון בפיקסלים. |
setAlignment(alignment) | VideoItem | מגדיר את היישור האופקי של הסרטון. |
setHelpText(text) | VideoItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setTitle(title) | VideoItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
setVideoUrl(youtubeUrl) | VideoItem | הסרטון עצמו מוגדר לפי כתובת URL נתונה ב-YouTube או מזהה וידאו ב-YouTube. |
setWidth(width) | VideoItem | מגדיר את רוחב הסרטון בפיקסלים. |
תיעוד מפורט
duplicate()
getAlignment()
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
getTitle()
הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem
).
החזרות
String
- הכותרת או טקסט הכותרת של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
getWidth()
הפונקציה מקבלת את רוחב הסרטון בפיקסלים.
החזרות
Integer
– הרוחב בפיקסלים
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setAlignment(alignment)
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setVideoUrl(youtubeUrl)
הסרטון עצמו מוגדר לפי כתובת URL נתונה ב-YouTube או מזהה וידאו ב-YouTube.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
youtubeUrl | String | כתובת ה-URL או המזהה ב-YouTube |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
מגדיר את רוחב הסרטון בפיקסלים. אפשר להגדיר רק את רוחב הסרטון. הגובה מוגדר באופן אוטומטי כדי לשמור על הפרופורציות של הסרטון.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
width | Integer | הרוחב בפיקסלים |
החזרות
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms