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

أماكن إقامة

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

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
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الوصف
titleStringاسم النموذج الجديد

استرجاع الكرة

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

الرميات

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

التفويض

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

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

createCheckboxGridValidation()

تعرض مثيلاً من CheckboxGrid تطويرBuilder والذي يمكن استخدامه لضبط التحقق من الصحة على 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');

المَعلمات

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

المَعلمات

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

استرجاع الكرة

Form: النموذج الذي يتضمّن عنوان URL معيّنًا

الرميات

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

التفويض

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

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