السماح لنص برمجي بفتح Form
حالي أو إنشاء Form
جديد
// Open a form by ID. const existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. const newForm = FormApp.create('Form Name');
أماكن إقامة
الموقع | النوع | الوصف |
---|---|---|
Alignment | Alignment | قائمة بأنواع محاذاة الصور |
Destination | Destination | قائمة بأنواع الوجهات التي يمكنها تخزين الردود على النماذج |
Feedback | Feedback | قائمة بأنواع النموذج Feedbacks |
Item | Item | قائمة بأنواع النموذج Items |
Page | Page | قائمة بالسلوكيات المحتمَلة للتنقّل في الصفحات |
RatingIconType | RatingIconType | قائمة بأنواع رموز التقييم RatingIcons |
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
create(title) | Form | لإنشاء Form جديدة وإرجاعها |
create | Checkbox | تعرِض هذه السمة مثيلًا لـ CheckboxGridValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق في Checkbox . |
create | Checkbox | تعرِض مثيلًا من CheckboxValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من صحة ملف
Checkbox . |
create | Quiz | تعرِض هذه الدالة مثيلًا لـ QuizFeedbackBuilder يمكن استخدامه لضبط الملاحظات على Item قابل للتصنيف. |
create | Grid | تعرِض هذه السمة مثيلًا لـ GridValidationBuilder يمكن استخدامه لضبط عملية التحقّق في Grid . |
create | Paragraph | تعرِض هذه السمة مثيلًا لـ ParagraphTextValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من
a Paragraph . |
create | Text | تعرِض هذه الدالة مثيلًا لـ TextValidationBuilder يمكن استخدامه لضبط عملية التحقّق من الصحة في Text . |
get | Form | لعرض النموذج الذي يكون النص البرمجي مرتبطًا به. |
get | Ui | تعرِض مثيلًا لبيئة واجهة مستخدِم محرِّر النماذج التي تسمح للبرنامج النصي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية. |
open | Form | لعرض Form بالمعرّف المحدّد. |
open | Form | لعرض Form مع عنوان URL المحدّد. |
مستندات تفصيلية
create(title)
لإنشاء Form
جديدة وإرجاعها يُعرِض استثناءً إذا كان العنوان المحدَّد null
أو فارغًا.
// Create and open a form. const form = FormApp.create('Form Name');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | اسم النموذج الجديد |
الإرجاع
Form
- النموذج الجديد
عمليات الرمي
Error
- إذا كان العنوان المحدَّد هو null
أو فارغًا
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms
create Checkbox Grid Validation()
تعرِض هذه السمة مثيلًا لـ CheckboxGridValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق في Checkbox
.
الإرجاع
create Checkbox Validation()
تعرِض مثيلًا من CheckboxValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من صحة ملف
Checkbox
.
الإرجاع
create Feedback()
تعرِض هذه الدالة مثيلًا لـ QuizFeedbackBuilder يمكن استخدامه لضبط الملاحظات على Item
قابل للتصنيف.
الإرجاع
create Grid Validation()
تعرِض هذه السمة مثيلًا لـ GridValidationBuilder يمكن استخدامه لضبط عملية التحقّق في Grid
.
الإرجاع
create Paragraph Text Validation()
تعرِض هذه السمة مثيلًا لـ ParagraphTextValidationBuilder الذي يمكن استخدامه لضبط عملية التحقّق من
a Paragraph
.
الإرجاع
create Text Validation()
تعرِض هذه الدالة مثيلًا لـ TextValidationBuilder يمكن استخدامه لضبط عملية التحقّق من الصحة في Text
.
الإرجاع
get Active Form()
لعرض النموذج الذي يكون النص البرمجي مرتبطًا به. للتفاعل مع النماذج التي ليس فيها رمزبرمجي مرتبط بالحاويات، استخدِم open
أو open
بدلاً من ذلك.
// Get the form to which this script is bound. const form = FormApp.getActiveForm();
الإرجاع
Form
: النموذج المرتبط بالنصوص البرمجية، أو null
إذا لم تكن النصوص البرمجية مرتبطة بأحد
النماذج
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
get Ui()
تعرِض مثيلًا لبيئة واجهة مستخدِم محرِّر النماذج التي تسمح للبرنامج النصي بإضافة ميزات مثل القوائم ومربّعات الحوار والأشرطة الجانبية. لا يمكن للنص البرمجي التفاعل مع واجهة المستخدم إلا في الحالة التالية: النسخة الحالية من محرِّر نموذج مفتوح (وليس العرض الذي يراه المجيب)، وإذا كان النص البرمجي مرتبطًا بالنموذج. لمزيد من المعلومات، اطّلِع على أدلة قوائم الطعام ومربّعات الحوار والأشرطة الجانبية.
// 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
: مثيل لواجهة مستخدِم هذا النموذج
open By Id(id)
لعرض Form
بالمعرّف المحدّد. يُعرِض استثناءً إذا كان المعرّف غير صالح أو إذا لم يكن لدى
المستخدم الإذن بفتح النموذج.
// Open a form by ID. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | رقم تعريف النموذج المطلوب فتحه |
الإرجاع
Form
- النموذج الذي يتضمّن المعرّف المحدّد
عمليات الرمي
Error
- إذا كان المعرّف المقدَّم غير صالح أو لم يكن لدى المستخدم أذونات
كافية
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms
open By Url(url)
لعرض Form
مع عنوان URL المحدّد. يُعرِض استثناءً إذا كان عنوان URL غير صالح أو
لم يكن لدى المستخدم إذن بفتح النموذج.
// Open a form by URL. const form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit', );
المعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للنموذج المطلوب فتحه |
الإرجاع
Form
: النموذج الذي يتضمّن عنوان URL المحدّد
عمليات الرمي
Error
- إذا كان عنوان URL المحدَّد غير صالح أو لم يكن لدى المستخدم أذونات
كافية
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms