تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class FormApp

يسمح هذا الخيار للنص البرمجي بفتح Form حالية أو إنشاء رمز جديد.

// Open a form by ID.
var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
var newForm = FormApp.create('Form Name');

أماكن إقامة

الموقع	النوع	الوصف
`Alignment`	`Alignment`	تعداد أنواع محاذاة الصور.
`DestinationType`	`DestinationType`	يشير ذلك المصطلح إلى تعداد لأنواع الوجهات التي يمكنها تخزين الردود على النموذج.
`FeedbackType`	`FeedbackType`	تعداد أنواع النماذج `Feedbacks`.
`ItemType`	`ItemType`	تعداد أنواع النماذج `Items`.
`PageNavigationType`	`PageNavigationType`	تمثّل هذه السمة تعدادًا للسلوكيات المحتمَلة للتنقل بين الصفحات.

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`create(title)`	`Form`	تنشئ السمة `Form` جديدة وتعرضها.
`createCheckboxGridValidation()`	`CheckboxGridValidationBuilder`	عرض مثيل من CheckboxGridValidationBuilder الذي يمكن استخدامه لتعيين التحقق من الصحة على `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');

المعلمات

الاسم	النوع	الوصف
`title`	`String`	على اسم النموذج الجديد

الإرجاع

Form: النموذج الجديد

الرميات

Error: إذا كان العنوان المحدّد null أو فارغًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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

`createCheckboxGridValidation()`

عرض مثيل من CheckboxGridValidationBuilder الذي يمكن استخدامه لتعيين التحقق من الصحة على CheckboxGridItem

الإرجاع

CheckboxGridValidationBuilder

`createCheckboxValidation()`

عرض مثيل من CheckboxValidationBuilder الذي يمكن استخدامه لتعيين التحقق من الصحة على CheckboxItem

الإرجاع

CheckboxValidationBuilder

`createFeedback()`

لعرض نسخة افتراضية من QuizFeedbackBuilder التي يمكن استخدامها لضبط التعليقات على عنصر قابل لوضع الدرجات Item

الإرجاع

QuizFeedbackBuilder

`createGridValidation()`

تعرض هذه الدالة نسخة من GridValidationBuilder التي يمكن استخدامها لضبط التحقق من الصحة على GridItem.

الإرجاع

GridValidationBuilder

`createParagraphTextValidation()`

عرض مثيل من ParagraphTextValidationBuilder الذي يمكن استخدامه لتعيين التحقق من الصحة على ParagraphTextItem

الإرجاع

ParagraphTextValidationBuilder

`createTextValidation()`

تعرض هذه الدالة نسخة من TextValidationBuilder التي يمكن استخدامها لضبط التحقق من الصحة على TextItem.

الإرجاع

TextValidationBuilder

`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');

المعلمات

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

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL للنموذج لفتح

الإرجاع

Form: النموذج مع عنوان URL المحدّد

الرميات

Error: إذا كان عنوان URL المقدَّم غير صالح أو لم يكن لدى المستخدم محتوى كافٍ الأذونات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:

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