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.
const 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
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

المعلمات

الاسم	النوع	الوصف
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