يسمح هذا الإذن للنص البرمجي بفتح Form
حالي أو إنشاء نص جديد.
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
أماكن إقامة
الموقع | Type | الوصف |
---|---|---|
Alignment | Alignment | تعداد لأنواع محاذاة الصور. |
DestinationType | DestinationType | تعداد لأنواع الوجهات التي يمكنها تخزين الردود على النماذج |
FeedbackType | FeedbackType | تعداد لأنواع النموذج Feedbacks . |
ItemType | ItemType | تعداد لأنواع النموذج Items . |
PageNavigationType | PageNavigationType | قائمة بالسلوكيات المحتملة للتنقل في الصفحات. |
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
create(title) | Form | إنشاء Form جديد وعرضه. |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | تعرض مثيلاً من CheckboxGrid تطويرBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على CheckboxGridItem . |
createCheckboxValidation() | CheckboxValidationBuilder | تعرض مثيلاً لـ CheckboxValidationBuilder يمكن استخدامها لضبط عملية التحقق على
CheckboxItem . |
createFeedback() | QuizFeedbackBuilder | تعرض هذه الدالة مثيل QuizFeedbackBuilder الذي يمكن استخدامه لضبط الملاحظات على
Item قابل لوضع الدرجات. |
createGridValidation() | GridValidationBuilder | تعرض هذه الدالة مثيلاً لـ GridValidationBuilder يمكن استخدامها لضبط عملية التحقق على GridItem . |
createParagraphTextValidation() | ParagraphTextValidationBuilder | تعرض هذه الدالة مثيلاً من ParagraphTextvalidationBuilder الذي يمكن استخدامه لضبط التحقق من الصحة على ParagraphTextItem . |
createTextValidation() | TextValidationBuilder | تعرض مثيلاً لـ TextvalidationBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على TextItem . |
getActiveForm() | Form | تعرض النموذج الذي يكون النص البرمجي به مرتبطًا بالحاوية. |
getUi() | Ui | تعرض هذه الدالة مثيلاً لبيئة واجهة المستخدم في محرّر النموذج والتي تسمح للنص البرمجي بإضافة ميزات مثل القوائم ومربعات الحوار والأشرطة الجانبية. |
openById(id) | Form | يتم عرض Form بالمعرّف المحدّد. |
openByUrl(url) | Form | لعرض Form باستخدام عنوان URL المحدّد. |
الوثائق التفصيلية
create(title)
إنشاء Form
جديد وعرضه. توفّر استثناءات إذا كان العنوان المحدّد null
أو فارغًا.
// Create and open a form. var form = FormApp.create('Form Name');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | اسم النموذج الجديد |
استرجاع الكرة
Form
— النموذج الجديد
الرميات
Error
: إذا كان العنوان المحدَّد null
أو فارغًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
تعرض مثيلاً من CheckboxGrid تطويرBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على CheckboxGridItem
.
استرجاع الكرة
createCheckboxValidation()
تعرض مثيلاً لـ CheckboxValidationBuilder يمكن استخدامها لضبط عملية التحقق على
CheckboxItem
.
استرجاع الكرة
createFeedback()
تعرض هذه الدالة مثيل QuizFeedbackBuilder الذي يمكن استخدامه لضبط الملاحظات على
Item
قابل لوضع الدرجات.
استرجاع الكرة
createGridValidation()
تعرض هذه الدالة مثيلاً لـ GridValidationBuilder يمكن استخدامها لضبط عملية التحقق على GridItem
.
استرجاع الكرة
createParagraphTextValidation()
تعرض هذه الدالة مثيلاً من ParagraphTextvalidationBuilder الذي يمكن استخدامه لضبط التحقق من الصحة على ParagraphTextItem
.
استرجاع الكرة
createTextValidation()
تعرض مثيلاً لـ TextvalidationBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على TextItem
.
استرجاع الكرة
getActiveForm()
تعرض النموذج الذي يكون النص البرمجي به مرتبطًا بالحاوية. للتفاعل مع النماذج التي لا يكون النص البرمجي بها مرتبطًا بحاوية، استخدِم السمة openById(id)
أو openByUrl(url)
بدلاً من ذلك.
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
استرجاع الكرة
Form
: الصيغة التي يتم ربط النص البرمجي بها أو null
إذا لم يكن النص البرمجي مرتبطًا بنموذج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
تعرض هذه الدالة مثيلاً لبيئة واجهة المستخدم في محرّر النموذج والتي تسمح للنص البرمجي بإضافة ميزات مثل القوائم ومربعات الحوار والأشرطة الجانبية. لا يمكن أن يتفاعل النص البرمجي مع واجهة المستخدم إلا للمثيل الحالي لمحرِّر نموذج مفتوح (وليس العرض الذي يراه المجيب)، وفقط إذا كان النص مرتبطًا بالنموذج. لمزيد من المعلومات، يمكنك الاطّلاع على أدلة القوائم ومربعات الحوار والأشرطة الجانبية.
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
استرجاع الكرة
Ui
: مثيل لبيئة واجهة المستخدم في هذا النموذج
openById(id)
يتم عرض Form
بالمعرّف المحدّد. يوفّر استثناءً إذا كان المعرّف غير صالح أو لم يكن لدى المستخدم إذن لفتح النموذج.
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
المَعلمات
الاسم | Type | الوصف |
---|---|---|
id | String | رقم تعريف النموذج لفتحه |
استرجاع الكرة
Form
- النموذج الذي يتضمّن المعرّف المقدَّم
الرميات
Error
: في حال كان رقم التعريف المحدّد غير صالح أو لم يكن لدى المستخدم أذونات
كافية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms
openByUrl(url)
لعرض Form
باستخدام عنوان URL المحدّد. يوفّر استثناءً إذا كان عنوان URL غير صالح أو لم يكن لدى المستخدم إذن لفتح النموذج.
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
المَعلمات
الاسم | Type | الوصف |
---|---|---|
url | String | عنوان URL للنموذج الذي سيتم فتحه |
استرجاع الكرة
Form
: النموذج الذي يتضمّن عنوان URL معيّنًا
الرميات
Error
: إذا كان عنوان URL المحدّد غير صالح أو لم يكن لدى المستخدم أذونات كافية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms