عنصر تنسيق يعرض فيديو. يمكن الوصول إلى العناصر أو إنشاؤها من "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()
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)
لضبط المحاذاة الأفقية للفيديو.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
alignment | Alignment | والمحاذاة الأفقية |
استرجاع الكرة
VideoItem
— جهاز VideoItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
VideoItem
— جهاز VideoItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
VideoItem
— جهاز VideoItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setVideoUrl(youtubeUrl)
يضبط الفيديو نفسه من عنوان URL معيّن على YouTube أو معرّف فيديو على YouTube.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
youtubeUrl | String | عنوان URL أو المعرّف على YouTube |
استرجاع الكرة
VideoItem
— جهاز VideoItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setWidth(width)
لتعيين عرض الفيديو بالبكسل. يمكن ضبط عرض الفيديو فقط. يتم تعيين الارتفاع تلقائيًا للحفاظ على تناسب تناسب الفيديو.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
width | Integer | العرض بالبكسل |
استرجاع الكرة
VideoItem
— جهاز VideoItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms