Class FormApp

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تطبيق FormApp

يتيح نص برمجي فتح Form حالي أو إنشاء نص جديد.

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

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

أماكن إقامة

الخاصيةالنوعالوصف
AlignmentAlignmentتعداد أنواع محاذاة الصور.
DestinationTypeDestinationTypeتعداد أنواع من الوجهات التي يمكن أن تخزّن ردود النماذج.
FeedbackTypeFeedbackTypeتعداد أنواع النموذج Feedbacks
ItemTypeItemTypeتعداد أنواع النموذج Items
PageNavigationTypePageNavigationTypeتعداد السلوكيات المحتملة للتنقل في الصفحات.

الطُرق

الطريقةنوع الإرجاعوصف قصير
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');

المعلّمات

الاسمالنوعالوصف
titleStringاسم النموذج الجديد

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
idStringرقم تعريف النموذج المطلوب فتحه

تذكرة ذهاب وعودة

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

المعلّمات

الاسمالنوعالوصف
urlStringعنوان URL للنموذج المراد فتحه

تذكرة ذهاب وعودة

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

طرح

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

التفويض

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

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