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

Class VideoItem

פריט פריסה שמציג סרטון. אפשר לגשת לפריטים או ליצור אותם דרך 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()`

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

החזרות

VideoItem – עותק משוכפל של VideoItem, לשרשור

הרשאות

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

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

`getAlignment()`

העמודה הזו מאפשרת לראות את היישור האופקי של הסרטון.

החזרות

Alignment – היישור האופקי

הרשאות

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

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

`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

`getWidth()`

הפונקציה מקבלת את רוחב הסרטון בפיקסלים.

החזרות

Integer – הרוחב בפיקסלים

הרשאות

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

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

`setAlignment(alignment)`

מגדיר את היישור האופקי של הסרטון.

פרמטרים

שם	תיאור	התיאור
`alignment`	`Alignment`	היישור האופקי

החזרות

VideoItem — VideoItem, לשרשור

הרשאות

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

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

`setHelpText(text)`

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

פרמטרים

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

החזרות

VideoItem — VideoItem, לשרשור

הרשאות

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

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

`setTitle(title)`

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

פרמטרים

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

החזרות

VideoItem — VideoItem, לשרשור

הרשאות

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

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

`setVideoUrl(youtubeUrl)`

הסרטון עצמו מוגדר לפי כתובת URL נתונה ב-YouTube או מזהה וידאו ב-YouTube.

פרמטרים

שם	תיאור	התיאור
`youtubeUrl`	`String`	כתובת ה-URL או המזהה ב-YouTube

החזרות

VideoItem — VideoItem, לשרשור

הרשאות

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

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

`setWidth(width)`

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

פרמטרים

שם	תיאור	התיאור
`width`	`Integer`	הרוחב בפיקסלים

החזרות

VideoItem — VideoItem, לשרשור

הרשאות

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

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