تمت ترجمة هذه الصفحة بواسطة 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