Class Form

النموذج

نموذج يحتوي على خصائص وعناصر عامة تتضمن الخصائص العنوان والإعدادات ومكان والردود عليها. تتضمن العناصر عناصر الأسئلة مثل مربعات الاختيار أو عناصر الراديو، بينما يؤدي التخطيط تشير العناصر إلى أشياء مثل فواصل الصفحات. يمكن الوصول إلى النماذج أو إنشاؤها من FormApp.

// Open a form by ID and create a new spreadsheet.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var ss = SpreadsheetApp.create('Spreadsheet Name');

// Update form properties via chaining.
form.setTitle('Form Name')
    .setDescription('Description of form')
    .setConfirmationMessage('Thanks for responding!')
    .setAllowResponseEdits(true)
    .setAcceptingResponses(false);

// Update the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

الطُرق

الطريقةنوع الإرجاعوصف قصير
addCheckboxGridItem()CheckboxGridItemتُرفِق عنصرًا جديدًا بسؤال، يتم تقديمه على شكل شبكة من الأعمدة والصفوف، ويسمح لتحديد خيارات متعددة في كل صف من سلسلة مربعات الاختيار.
addCheckboxItem()CheckboxItemلإلحاق عنصر جديد في السؤال يتيح للمجيب تحديد مربع اختيار واحد أو أكثر، بالإضافة إلى خيار "غير ذلك" .
addDateItem()DateItemلإلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى تاريخ
addDateTimeItem()DateTimeItemلإلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى التاريخ والوقت
addDurationItem()DurationItemيتم إلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى المدة الزمنية.
addEditor(emailAddress)Formيؤدي هذا الإجراء إلى إضافة المستخدم المحدّد إلى قائمة محرّري Form.
addEditor(user)Formيؤدي هذا الإجراء إلى إضافة المستخدم المحدّد إلى قائمة محرّري Form.
addEditors(emailAddresses)Formلإضافة مصفوفة معيّنة من المستخدمين إلى قائمة المحرِّرين في Form
addGridItem()GridItemتُرفِق عنصرًا جديدًا بسؤال، يتم تقديمه على شكل شبكة من الأعمدة والصفوف، ويسمح لتحديد خيار واحد لكل صف من سلسلة أزرار الاختيار.
addImageItem()ImageItemتُستخدَم لإلحاق عنصر تنسيق جديد يعرض صورة.
addListItem()ListItemإلحاق عنصر جديد في السؤال يتيح للمجيب اختيار خيار واحد من قائمة منسدلة الحالية.
addMultipleChoiceItem()MultipleChoiceItemتضيف عنصر سؤال جديدًا يسمح للمجيب باختيار واحد من قائمة الراديو أو زر اختياري "other" .
addPageBreakItem()PageBreakItemتضيف عنصر تنسيق جديدًا يميّز بداية الصفحة.
addParagraphTextItem()ParagraphTextItemتضيف عنصر سؤال جديدًا يسمح للمجيب بإدخال جزء من النص.
addScaleItem()ScaleItemإلحاق عنصر جديد في السؤال يتيح للمجيب اختيار خيار واحد من عنصر مرقم تسلسل أزرار الاختيار.
addSectionHeaderItem()SectionHeaderItemتُرفِق هذه الدالة عنصر تنسيق جديدًا يشير إلى بداية القسم بشكل مرئي.
addTextItem()TextItemيتم إلحاق عنصر جديد من السؤال يسمح للمجيب بإدخال سطر واحد من النص.
addTimeItem()TimeItemيتم إلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى وقت من اليوم.
addVideoItem()VideoItemلإلحاق عنصر تنسيق جديد يعرض فيديو.
canEditResponse()Booleanتحدِّد ما إذا كان النموذج يعرض رابطًا لتعديل ردّ بعد إرساله.
collectsEmail()Booleanتحدد ما إذا كان النموذج يجمع المستجيبين .
createResponse()FormResponseيتم إنشاء رد جديد على النموذج.
deleteAllResponses()Formيؤدي هذا الإجراء إلى حذف جميع الردود المُرسَلة من مخزن ردود النموذج.
deleteItem(index)voidلحذف العنصر في فهرس معين بين جميع العناصر في النموذج.
deleteItem(item)voidلحذف العنصر المحدّد.
deleteResponse(responseId)Formحذف رد واحد من مخزن ردود النموذج.
getConfirmationMessage()Stringستتلقّى رسالة تأكيد النموذج.
getCustomClosedFormMessage()Stringالحصول على الرسالة المخصصة التي يتم عرضها إذا كان النموذج لا يقبل الردود أو إذا كان النموذج فارغًا في حال عدم ضبط رسالة مخصّصة.
getDescription()Stringالحصول على وصف النموذج
getDestinationId()Stringالحصول على رقم تعريف وجهة الرد على النموذج
getDestinationType()DestinationTypeالحصول على نوع وجهة الرد على النموذج
getEditUrl()Stringالحصول على عنوان URL الذي يمكن استخدامه للوصول إلى وضع التعديل في النموذج
getEditors()User[]يحصل على قائمة محرّري Form هذا.
getId()Stringالحصول على رقم تعريف النموذج
getItemById(id)Itemيحصل على العنصر بمعرّف معين.
getItems()Item[]الحصول على مصفوفة من جميع العناصر في النموذج.
getItems(itemType)Item[]توفر هذه الدالة صفيفًا من جميع العناصر من نوع معيّن.
getPublishedUrl()Stringالحصول على عنوان URL الذي يمكن استخدامه للرد على النموذج
getResponse(responseId)FormResponseيحصل على ردّ واحد على النموذج استنادًا إلى رقم تعريف الردّ.
getResponses()FormResponse[]للحصول على مصفوفة من جميع ردود النموذج.
getResponses(timestamp)FormResponse[]الحصول على مصفوفة من جميع ردود النموذج بعد تاريخ ووقت محدّدين
getShuffleQuestions()Booleanتحدد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج يتم عشوائيًا.
getSummaryUrl()Stringالحصول على عنوان URL الذي يمكن استخدامه لعرض ملخّص ردود النموذج
getTitle()Stringالحصول على عنوان النموذج
hasLimitOneResponsePerUser()Booleanيحدد ما إذا كان النموذج يسمح فقط برد واحد لكل مستجيب.
hasProgressBar()Booleanتحدِّد هذه السياسة ما إذا كان النموذج يعرض شريط تقدّم.
hasRespondAgainLink()Booleanتحدِّد ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد المجيب يكمل النموذج.
isAcceptingResponses()Booleanتحدِّد هذه السياسة ما إذا كان النموذج يقبل حاليًا الردود.
isPublishingSummary()Booleanتحدِّد ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد المجيب يكمل النموذج.
isQuiz()Booleanتحدِّد ما إذا كان النموذج اختبارًا.
moveItem(from, to)Itemلنقل عنصر في فهرس معين بين جميع العناصر في النموذج إلى فهرس معين آخر.
moveItem(item, toIndex)Itemلنقل عنصر معين إلى فهرس معين بين جميع العناصر في النموذج.
removeDestination()Formإلغاء ربط النموذج بوجهة الردّ الحالية
removeEditor(emailAddress)Formإزالة المستخدم المحدّد من قائمة محرِّري Form
removeEditor(user)Formإزالة المستخدم المحدّد من قائمة محرِّري Form
requiresLogin()Booleanيحدد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو نطاق فرعي قبل الرد.
setAcceptingResponses(enabled)Formتحدِّد هذه السياسة ما إذا كان النموذج يقبل الردود حاليًا.
setAllowResponseEdits(enabled)Formتحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لتعديل الردّ بعد إرساله.
setCollectEmail(collect)Formتحدِّد ما إذا كان النموذج يجمع المجيبين .
setConfirmationMessage(message)Formإعداد رسالة تأكيد النموذج
setCustomClosedFormMessage(message)Formلضبط الرسالة لعرضها إذا كان النموذج لا يقبل الردود.
setDescription(description)Formلضبط وصف النموذج.
setDestination(type, id)Formتحدِّد هذه السياسة الوجهة التي يتم حفظ الردود على النموذج فيها.
setIsQuiz(enabled)Formتحدد ما إذا كان النموذج اختبارًا.
setLimitOneResponsePerUser(enabled)Formتحدِّد هذه السياسة ما إذا كان النموذج يسمح فقط برد واحد لكل مجيب.
setProgressBar(enabled)Formلتحديد ما إذا كان النموذج يحتوي على شريط تقدّم.
setPublishingSummary(enabled)Formتحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد إرسال أحد المستجيبين. النموذج.
setRequireLogin(requireLogin)Formلتحديد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو النطاق الفرعي قبل الرد.
setShowLinkToRespondAgain(enabled)Formلضبط ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد إكمال المجيب النموذج.
setShuffleQuestions(shuffle)Formلتحديد ما إذا كان سيتم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا.
setTitle(title)Formلضبط عنوان النموذج.
shortenFormUrl(url)Stringتحوِّل عنوان URL الطويل الخاص بنموذج إلى عنوان URL مختصر.
submitGrades(responses)Formيؤدي هذا الخيار إلى إرسال الدرجات لنماذج الردود المقدَّمة في النموذج.

الوثائق التفصيلية

addCheckboxGridItem()

تُرفِق عنصرًا جديدًا بسؤال، يتم تقديمه على شكل شبكة من الأعمدة والصفوف، ويسمح لتحديد خيارات متعددة في كل صف من سلسلة مربعات الاختيار.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a checkbox grid item.
const item = form.addCheckboxGridItem();

// Sets the title 'Where did you celebrate New Year's?'
item.setTitle('Where did you celebrate New Year's?');

// Sets the grid's rows and columns.
item.setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

الإرجاع

CheckboxGridItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addCheckboxItem()

لإلحاق عنصر جديد في السؤال يتيح للمجيب تحديد مربع اختيار واحد أو أكثر، بالإضافة إلى خيار "غير ذلك" .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a checkbox item.
const item = form.addCheckboxItem();

// Sets the title of the checkbox item to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the choices.
item.setChoiceValues(['Cats', 'Dogs']);

الإرجاع

CheckboxItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addDateItem()

لإلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى تاريخ

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a date item.
const item = form.addDateItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the description for the date item.
item.setHelpText('Some helper text.');

الإرجاع

DateItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addDateTimeItem()

يتم إلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى التاريخ والوقت.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with date and time inputs.
const item = form.addDateTimeItem();

// Sets the title to 'When were you born?'
item.setTitle('When were you born?');

// Sets the question as required.
item.setRequired(true);

الإرجاع

DateTimeItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addDurationItem()

يتم إلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى المدة الزمنية.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with a duration input.
const item = form.addDurationItem();

// Sets the title to 'How long can you hold your breath?'
item.setTitle('How long can you hold your breath?');

// Sets the question as required.
item.setRequired(true);

الإرجاع

DurationItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addEditor(emailAddress)

يؤدي هذا الإجراء إلى إضافة المستخدم المحدّد إلى قائمة محرّري Form. إذا كان المستخدم قد في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدِم الذي تريد إضافته.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

addEditor(user)

يؤدي هذا الإجراء إلى إضافة المستخدم المحدّد إلى قائمة محرّري Form. إذا كان المستخدم قد في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إضافته

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

addEditors(emailAddresses)

لإضافة مصفوفة معيّنة من المستخدمين إلى قائمة المحرِّرين في Form إذا كانت أي من كان المستخدمون مدرجين بالفعل في قائمة المشاهدين، تُدرجهم هذه الطريقة في قائمة المشاهدين المشاهدون.

المعلمات

الاسمالنوعالوصف
emailAddressesString[]مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

addGridItem()

تُلحِق عنصر سؤال جديدًا، يتم تقديمه على شكل شبكة من الأعمدة والصفوف، للسماح لتحديد خيار واحد لكل صف من سلسلة أزرار الاختيار.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a multiple choice grid.
const item = form.addGridItem();

// Sets the title to 'Rate your interests.'
item.setTitle('Rate your interests');

// Sets the grid's rows and columns.
item.setRows(['Cars', 'Computers', 'Celebrities'])
  .setColumns(['Boring', 'So-so', 'Interesting']);

الإرجاع

GridItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addImageItem()

تُستخدَم لإلحاق عنصر تنسيق جديد يعرض صورة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds an image item.
const item = form.addImageItem();

// Gets the Google icon to use as the image.
const img = UrlFetchApp.fetch('https://fonts.gstatic.com/s/i/productlogos/googleg/v6/web-24dp/logo_googleg_color_1x_web_24dp.png');

// Sets the image, title, and description for the item.
item.setTitle('Google icon').setHelpText('Google icon').setImage(img);

الإرجاع

ImageItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addListItem()

إلحاق عنصر جديد في السؤال يتيح للمجيب اختيار خيار واحد من قائمة منسدلة الحالية.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a dropdown list to the form.
const item = form.addListItem();

// Sets the title to 'Do you prefer cats or dogs?'
item.setTitle('Do you prefer cats or dogs?');

// Sets the description to 'This is description text...'
item.setHelpText('This is description text...');

// Creates and adds choices to the dropdown list.
item.setChoices([
  item.createChoice('dog'),
  item.createChoice('cat')
]);

الإرجاع

ListItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addMultipleChoiceItem()

تضيف عنصر سؤال جديدًا يسمح للمجيب باختيار واحد من قائمة الراديو أو زر اختياري "other" .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a multiple choice item to the form.
const item = form.addMultipleChoiceItem();

// Sets the title.
item.setTitle('What is your favorite ice cream flavor?');

// Creates some choice items.
const vanilla = item.createChoice('vanilla');
const chocolate = item.createChoice('chocolate');
const strawberry = item.createChoice('strawberry');

// Sets the choices.
item.setChoices([vanilla, chocolate, strawberry]);

الإرجاع

MultipleChoiceItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addPageBreakItem()

تضيف عنصر تنسيق جديدًا يميّز بداية الصفحة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds page break items to create a second and third page for the form.
const pageTwo = form.addPageBreakItem();
const pageThree = form.addPageBreakItem();

// Sets the titles for the pages.
pageTwo.setTitle('Page two');
pageThree.setTitle('Page three');

// Upon completion of the first page, sets the form to navigate to the third page.
pageTwo.setGoToPage(pageThree);

// Upon completion of the second page, sets the form to navigate back to the first page.
pageThree.setGoToPage(FormApp.PageNavigationType.RESTART);

الإرجاع

PageBreakItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addParagraphTextItem()

تضيف عنصر سؤال جديدًا يسمح للمجيب بإدخال جزء من النص.

// Opens the form by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the paragraph text item.
const item = form.addParagraphTextItem();

// Sets the title to 'What is your address?'
item.setTitle('What is your address?');

الإرجاع

ParagraphTextItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addScaleItem()

إلحاق عنصر جديد في السؤال يتيح للمجيب اختيار خيار واحد من عنصر مرقم تسلسل أزرار الاختيار.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the scale item.
const item = form.addScaleItem();

// Sets the title of the scale item to 'Choose a number.'
item.setTitle('Choose a number');

// Sets the scale to 1-5.
item.setBounds(1, 5);

// Sets the label for the lower and upper bounds.
item.setLabels('Lowest', 'Highest');

الإرجاع

ScaleItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addSectionHeaderItem()

تُرفِق هذه الدالة عنصر تنسيق جديدًا يشير إلى بداية القسم بشكل مرئي.

 // Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds the section heading item.
const item = form.addSectionHeaderItem();

// Sets the title to 'Title of new section.'
item.setTitle('Title of new section');

// Sets the description.
item.setHelpText('Description of new section');

الإرجاع

SectionHeaderItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addTextItem()

يتم إلحاق عنصر جديد من السؤال يسمح للمجيب بإدخال سطر واحد من النص.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a single-line text item.
const item = form.addTextItem();

// Sets the title to 'What is your name?'
item.setTitle('What is your name?');

الإرجاع

TextItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addTimeItem()

يتم إلحاق عنصر جديد في السؤال يسمح للمجيب بالإشارة إلى وقت من اليوم.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a question with a time input.
const item = form.addTimeItem();

// Sets the title to 'What time do you usually wake up in the morning?'
item.setTitle('What time do you usually wake up in the morning?');

الإرجاع

TimeItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

addVideoItem()

لإلحاق عنصر تنسيق جديد يعرض فيديو.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Adds a video item.
const item = form.addVideoItem();

// Sets the title, description, and video.
item.setTitle('YouTube video')
  .setHelpText('Send content automatically via Google Sheets and Apps Script')
  .setVideoUrl('https://youtu.be/xxgQr-jSu9o');

// Sets the alignment to the center.
item.setAlignment(FormApp.Alignment.CENTER);

الإرجاع

VideoItem — العنصر الذي تم إنشاؤه حديثًا.

التفويض

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

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

canEditResponse()

تحدِّد ما إذا كان النموذج يعرض رابطًا لتعديل ردّ بعد إرساله.

بغض النظر عن هذا الإعداد، تسمح الطريقة FormResponse.getEditResponseUrl() مؤلف النص البرمجي الذي لديه حق تعديل النموذج لإنشاء عنوان URL يمكن استخدامه لتعديل الاستجابة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Checks if the form displays a link to edit a response after submitting it.
// The default is false. To let people edit their responses, use
// form.setAllowResponseEdits(true).
const edit = form.canEditResponse();

// If the form doesn't let people edit responses, logs false to the console.
console.log(edit);

الإرجاع

Booleantrue إذا كان النموذج يعرض رسالة "تعديل ردك" رابط؛ false إذا كانت لا.

التفويض

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

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

collectsEmail()

تحدد ما إذا كان النموذج يجمع المستجيبين .

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to not collect respondents' email addresses.
form.setCollectEmail(false);

// Checks whether the form collects respondents' email addresses and logs it to the console.
const bool = form.collectsEmail();

console.log(bool);

الإرجاع

Booleantrue إذا كان النموذج يجمع عناوين البريد الإلكتروني false إذا لم يتم تحديده.

التفويض

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

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

createResponse()

يتم إنشاء رد جديد على النموذج. للإجابة عن عنصر سؤال، يمكنك إنشاء ItemResponse. من العنصر، ثم إرفاقه بالردّ على هذا النموذج من خلال الاتصال بالرقم FormResponse.withItemResponse(response). لحفظ الردّ المجمّع، يُرجى الاتصال بالرقم FormResponse.submit().

الإرجاع

FormResponse: الردّ الذي تم إنشاؤه حديثًا للنموذج

التفويض

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

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

deleteAllResponses()

يؤدي هذا الإجراء إلى حذف جميع الردود المُرسَلة من مخزن ردود النموذج. لا يؤدي هذا الإجراء إلى حذف نسخ من الردود المخزنة في وجهة استجابة خارجية (مثل جدول بيانات)، ولكنها محو عرض ملخص النموذج.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

deleteItem(index)

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

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets all the items from the form.
const items = form.getItems();

// Finds the index of a paragraph text item and deletes it by the item's index.
const index = items.findIndex(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT);
if (index !== -1) {
  form.deleteItem(index);
}

المعلمات

الاسمالنوعالوصف
indexIntegerفهرس العنصر بين جميع العناصر في النموذج.

الرميات

Error: في حال عدم توفّر أي عنصر في الفهرس المحدَّد

التفويض

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

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

deleteItem(item)

لحذف العنصر المحدّد. عرض استثناء لبرمجة نصية إذا تم حذف العنصر من قبل

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets all of the items from the form.
const items = form.getItems();

// Finds a paragraph text item and deletes it.
const item = items.find(item => item.getType() === FormApp.ItemType.PARAGRAPH_TEXT);
if (item) {
  form.deleteItem(item);
}

المعلمات

الاسمالنوعالوصف
itemItemالعنصر المطلوب حذفه.

الرميات

Error: إذا لم يتوفّر العنصر في النموذج

التفويض

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

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

deleteResponse(responseId)

حذف رد واحد من مخزن ردود النموذج. لا تحذف هذه الطريقة نُسخًا من الردود المخزنة في وجهة رد خارجية (مثل جدول بيانات)، ولكنها تزيل الرد من عرض الملخص للنموذج. يمكن استرداد رقم تعريف الردّ باستخدام FormResponse.getId().

المعلمات

الاسمالنوعالوصف
responseIdStringرقم تعريف الردّ على النموذج المطلوب حذفه

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

getConfirmationMessage()

ستتلقّى رسالة تأكيد النموذج.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the confirmation message to display after someone submits the form.
form.setConfirmationMessage('You successfully submitted the form.');

// Gets the confirmation message and logs it to the console.
const message = form.getConfirmationMessage();

console.log(message);

الإرجاع

String — رسالة تأكيد النموذج

التفويض

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

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

getCustomClosedFormMessage()

الحصول على الرسالة المخصصة التي يتم عرضها إذا كان النموذج لا يقبل الردود أو إذا كان النموذج فارغًا في حال عدم ضبط رسالة مخصّصة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets a custom closed form message to display to the user when the form
// no longer accepts responses.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();

console.log(message);

الإرجاع

String - الرسالة المخصصة التي سيتم عرضها إذا كان النموذج لا يقبل الردود، أو إذا كانت فارغة في حال عدم ضبط رسالة مخصّصة.

التفويض

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

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

getDescription()

الحصول على وصف النموذج

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form description.
form.setDescription('This is the form description.');

// Gets the form description and logs it to the console.
const description = form.getDescription();

console.log(description);

الإرجاع

String — وصف النموذج

التفويض

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

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

getDestinationId()

الحصول على رقم تعريف وجهة الرد على النموذج

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Creates a spreadsheet to use as the response destination.
const ss = SpreadsheetApp.create('Test_Spreadsheet');

// Updates the form's response destination.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Gets the ID of the form's response destination and logs it to the console.
const destinationId = form.getDestinationId();

console.log(destinationId);

الإرجاع

String — رقم تعريف وجهة الرد على النموذج

التفويض

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

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

getDestinationType()

الحصول على نوع وجهة الرد على النموذج

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc1234556/edit');

// Gets the type of the form's response destination and logs it to the console.
const destinationType = form.getDestinationType().name();

console.log(destinationType);

الإرجاع

DestinationType — نوع وجهة الرد على النموذج

التفويض

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

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

getEditUrl()

الحصول على عنوان URL الذي يمكن استخدامه للوصول إلى وضع التعديل في النموذج

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL that accesses the form's edit mode and logs it to the console.
const url = form.getEditUrl();

console.log(url);

الإرجاع

String: عنوان URL لتعديل النموذج

التفويض

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

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

getEditors()

يحصل على قائمة محرّري Form هذا.

الإرجاع

User[] — مصفوفة من المستخدمين الذين لديهم إذن تعديل.

التفويض

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

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

getId()

الحصول على رقم تعريف النموذج

// Opens the form by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the ID of the form and logs it to the console.
const id = form.getId();

console.log(id);

الإرجاع

String — رقم تعريف النموذج

التفويض

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

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

getItemById(id)

يحصل على العنصر بمعرّف معين. تعرض null إذا لم يكن المعرّف مطابقًا لعنصر في النموذج.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the ID of the first item on the form.
const itemId = form.getItems()[0].getId();

// Gets the item from the ID.
const item = form.getItemById(itemId);

// Gets the name of the item type and logs it to the console.
const type = item.getType().name();

console.log(type);

المعلمات

الاسمالنوعالوصف
idIntegerمعرّف السلعة

الإرجاع

Item — العنصر ذو المعرّف المحدّد، أو null إذا لم يكن متوفّرًا في النموذج

التفويض

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

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

getItems()

الحصول على مصفوفة من جميع العناصر في النموذج.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the list of items in the form.
const items = form.getItems();

// Gets the type for each item and logs them to the console.
const types = items.map((item) => item.getType().name());

console.log(types);

الإرجاع

Item[] — مصفوفة من جميع العناصر في النموذج.

التفويض

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

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

getItems(itemType)

توفر هذه الدالة صفيفًا من جميع العناصر من نوع معيّن.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets a list of all checkbox items on the form.
const items = form.getItems(FormApp.ItemType.CHECKBOX);

// Gets the title of each checkbox item and logs them to the console.
const checkboxItemsTitle = items.map((item) => item.asCheckboxItem().getTitle());
console.log(checkboxItemsTitle);

المعلمات

الاسمالنوعالوصف
itemTypeItemTypeنوع العناصر المطلوب استردادها.

الإرجاع

Item[] — مصفوفة من جميع العناصر من هذا النوع.

التفويض

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

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

getPublishedUrl()

الحصول على عنوان URL الذي يمكن استخدامه للرد على النموذج

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL to respond to the form and logs it to the console.
const url = form.getPublishedUrl();
console.log(url);

الإرجاع

String: عنوان URL المخصص للردّ على النموذج

التفويض

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

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

getResponse(responseId)

يحصل على ردّ واحد على النموذج استنادًا إلى رقم تعريف الردّ. يمكن استرداد أرقام تعريف الردود من FormResponse.getId().

المعلمات

الاسمالنوعالوصف
responseIdStringرقم تعريف الردّ على النموذج.

الإرجاع

FormResponse — الرد على النموذج

الرميات

Error: إذا لم يتوفّر الرد

التفويض

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

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

getResponses()

للحصول على مصفوفة من جميع ردود النموذج.

الإرجاع

FormResponse[] — مصفوفة من جميع ردود النموذج.

التفويض

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

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

getResponses(timestamp)

الحصول على مصفوفة من جميع ردود النموذج بعد تاريخ ووقت محدّدين

المعلمات

الاسمالنوعالوصف
timestampDateأقرب تاريخ ووقت يجب عرض الردود على النموذج خلاله.

الإرجاع

FormResponse[] — قائمة الردود على النموذج

التفويض

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

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

getShuffleQuestions()

تحدد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج يتم عشوائيًا.

الإرجاع

Booleantrue إذا تم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا false إذا لم يكن كذلك.

التفويض

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

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

getSummaryUrl()

الحصول على عنوان URL الذي يمكن استخدامه لعرض ملخّص ردود النموذج ما لم يتم ضبط setPublishingSummary(enabled) على true، لن يتم ضبط سوى المستخدمين الذين لديهم إذن تعديل على الوصول إلى عنوان URL.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the URL to view a summary of the form's responses and logs it to the console.
const url = form.getSummaryUrl();
console.log(url);

الإرجاع

String — عنوان URL لعرض ملخص الردود

التفويض

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

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

getTitle()

الحصول على عنوان النموذج

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the title of the form to 'For_Testing.'
form.setTitle('For_Testing');

// Gets the title of the form and logs it to the console.
const title = form.getTitle();
console.log(title);

الإرجاع

String — عنوان النموذج

التفويض

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

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

hasLimitOneResponsePerUser()

يحدِّد ما إذا كان النموذج يسمح فقط برد واحد لكل مجيب. إذا كانت القيمة هي true، لن يتمكن النص البرمجي من إرسال ردود على النموذج على الإطلاق.

الإرجاع

Booleantrue إذا كان النموذج يسمح فقط برد واحد لكل مستجيب false إذا لم يكن كذلك.

التفويض

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

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

hasProgressBar()

تحدِّد هذه السياسة ما إذا كان النموذج يعرض شريط تقدّم.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// Opens the form by its URL.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks if the form displays a progress bar and logs it to the console.
console.log(form.hasProgressBar());

الإرجاع

Booleantrue إذا كان النموذج يعرض شريط تقدم false إذا لم يتم تحديده.

التفويض

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

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

تحدِّد ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد المجيب يكمل النموذج.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to display a link to submit another
// response after someone submits the form.
form.setShowLinkToRespondAgain(true);

// Checks if the form displays a 'Submit another response' link and logs it to the console.
console.log(form.hasRespondAgainLink());

الإرجاع

Booleantrue إذا كان النموذج يعرض الرسالة "إرسال رد آخر" رابط؛ false إذا كانت لا.

التفويض

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

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

isAcceptingResponses()

تحدِّد هذه السياسة ما إذا كان النموذج يقبل حاليًا الردود.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks if the form is accepting responses or not and logs it to the console.
const accepting = form.isAcceptingResponses();
console.log(accepting);

الإرجاع

Booleantrue إذا كان النموذج يقبل الردود false إذا لم يكن كذلك.

التفويض

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

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

isPublishingSummary()

تحدِّد ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد المجيب يكمل النموذج.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to display a link to a summary of
// the responses after someone submits the form.
form.setPublishingSummary(true);

// Checks if the form displays a "See previous responses" link and logs it to the console.
const publishingLink = form.isPublishingSummary();
console.log(publishingLink);

الإرجاع

Booleantrue إذا كان النموذج يعرض الرسالة "الاطّلاع على الردود السابقة" رابط؛ false إذا كانت لا.

التفويض

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

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

isQuiz()

تحدِّد ما إذا كان النموذج اختبارًا.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form as a quiz.
form.setIsQuiz(true);

// Checks if the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

الإرجاع

Booleantrue إذا كان النموذج يقبل الردود false إذا لم يكن كذلك.

التفويض

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

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

moveItem(from, to)

لنقل عنصر في فهرس معين بين جميع العناصر في النموذج إلى فهرس معين آخر. يرمي استثناء البرمجة النصية إذا كان فهرس to خارج الحدود.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Moves the first item to be the last item.
form.moveItem(0, form.getItems().length - 1);

المعلمات

الاسمالنوعالوصف
fromIntegerالفهرس الحالي للسلعة بين جميع العناصر في النموذج.
toIntegerالفهرس الجديد للعنصر بين جميع العناصر في النموذج.

الإرجاع

Item — العنصر الذي تم نقله

الرميات

Error: إذا كان أيّ من الفهرسَين خارج الحدود المسموح بها

التفويض

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

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

moveItem(item, toIndex)

لنقل عنصر معين إلى فهرس معين بين جميع العناصر في النموذج. عرض نص برمجي باستثناء إذا كان الفهرس المحدد خارج الحدود.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Gets the first item.
const item = form.getItems()[0];

// Moves the item to be the last item.
form.moveItem(item, form.getItems().length - 1);

المعلمات

الاسمالنوعالوصف
itemItemالعنصر المطلوب نقله.
toIndexIntegerالفهرس الجديد للعنصر بين جميع العناصر في النموذج.

الإرجاع

Item — العنصر الذي تم نقله

الرميات

Error: إذا كان الفهرس خارج الحدود.

التفويض

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

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

removeDestination()

إلغاء ربط النموذج بوجهة الردّ الحالية لا تزال الوجهة السابقة غير المرتبطة بنسخة من جميع الردود السابقة. جميع النماذج، بما في ذلك تلك التي لا تحتوي على بشكل صريح، احفظ نسخة من الردود في متجر ردود النموذج. إذا لم يكن النموذج يحتوي حاليًا على الرد، فلن يكون لهذه الطريقة أي تأثير.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Opens a spreadsheet to use for the response destination.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Updates the form's response destination to the spreadsheet.
form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());

// Unlinks the form from the spreadsheet.
form.removeDestination();

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

removeEditor(emailAddress)

إزالة المستخدم المحدّد من قائمة محرِّري Form هذه الطريقة لا منع المستخدمين من الوصول إلى "Form" إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن بالوصول العام: على سبيل المثال، إذا تمت مشاركة Form مع كامل أو إذا كان Form في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، سيؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
emailAddressStringعنوان البريد الإلكتروني للمستخدم المطلوب إزالته.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

removeEditor(user)

إزالة المستخدم المحدّد من قائمة محرِّري Form هذه الطريقة لا منع المستخدمين من الوصول إلى "Form" إذا كانوا ينتمون إلى فئة من المستخدمين لديهم إذن بالوصول العام: على سبيل المثال، إذا تمت مشاركة Form مع كامل أو إذا كان Form في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.

وبالنسبة إلى ملفات Drive، سيؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.

المعلمات

الاسمالنوعالوصف
userUserتمثيل للمستخدم المطلوب إزالته

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

requiresLogin()

يحدد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو نطاق فرعي قبل الرد.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Checks if the form requires respondents to log in to a Google Workspace account
// before responding and logs it to the console.
const login = form.requiresLogin();
console.log(login);

الإرجاع

Booleantrue إذا كان النموذج يتطلب من المستخدمين تسجيل الدخول false إذا لم يتم تحديده.


setAcceptingResponses(enabled)

تحدِّد هذه السياسة ما إذا كان النموذج يقبل الردود حاليًا. الإعداد التلقائي للنماذج الجديدة هو true.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to accept responses.
form.setAcceptingResponses(true);

// Checks whether the form is accepting responses or not and logs it to the console.
console.log(form.isAcceptingResponses());

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان على النموذج قبول الردود false إذا كان لا ينبغي ذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setAllowResponseEdits(enabled)

تحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لتعديل الردّ بعد إرساله. الإعداد الافتراضي النماذج الجديدة هي false.

بغض النظر عن هذا الإعداد، تسمح الطريقة FormResponse.getEditResponseUrl() مؤلف النص البرمجي الذي لديه إذن تعديل على النموذج لإنشاء عنوان URL يمكن استخدامه لتعديل الاستجابة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Shows "Edit your response" link after someone submits the form.
form.setAllowResponseEdits(true);

// Checks whether the option to edit the form after a user submits it is set to true or not
// and logs it to the console.
console.log(form.canEditResponse());

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان يجب أن يعرض النموذج "تعديل ردّك" رابط؛ false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setCollectEmail(collect)

تحدِّد ما إذا كان النموذج يجمع المجيبين . الإعداد التلقائي للنماذج الجديدة هو false

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to collect respondents' email addresses.
form.setCollectEmail(true);

// Checks whether the value is set to true or false and logs it to the console.
const collect = form.collectsEmail();
console.log(collect);

المعلمات

الاسمالنوعالوصف
collectBooleantrue إذا كان يجب أن يجمع النموذج عناوين البريد الإلكتروني false إذا كان لا.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setConfirmationMessage(message)

إعداد رسالة تأكيد النموذج

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets a custom confirmation message to display after someone submits the form.
form.setConfirmationMessage('Your form has been successfully submitted.');

// Gets the confirmation message set for the form and logs it to the console.
const message = form.getConfirmationMessage();
console.log(message);

المعلمات

الاسمالنوعالوصف
messageStringهي رسالة التأكيد الجديدة للنموذج.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setCustomClosedFormMessage(message)

لضبط الرسالة لعرضها إذا كان النموذج لا يقبل الردود. إذا لم يتم تعيين أي رسالة، فسيتم النموذج رسالة تلقائية.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form to not accept responses.
form.setAcceptingResponses(false);

// Sets a custom closed form message to display to the user.
form.setCustomClosedFormMessage('The form is no longer accepting responses.');

// Gets the custom message set for the form and logs it to the console.
const message = form.getCustomClosedFormMessage();
console.log(message);

المعلمات

الاسمالنوعالوصف
messageStringالرسالة التي يتم عرضها إذا كان النموذج لا يقبل الردود.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setDescription(description)

لضبط وصف النموذج.

المعلمات

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

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setDestination(type, id)

تحدِّد هذه السياسة الوجهة التي يتم حفظ الردود على النموذج فيها. جميع النماذج، بما في ذلك تلك التي لا تعيين وجهة بشكل صريح، يُرجى حفظ نسخة من الردود في مخزن الردود.

المعلمات

الاسمالنوعالوصف
typeDestinationTypeنوع وجهة الرد على النموذج
idStringرقم تعريف وجهة الرد على النموذج

الإرجاع

Form — هذا Form، للسلسلة.

الرميات

Error: إذا كان رقم تعريف الوجهة المحدّد غير صالح

التفويض

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

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

setIsQuiz(enabled)

تحدد ما إذا كان النموذج اختبارًا. الإعداد التلقائي للنماذج الجديدة هو false.

لا يُسمح بالأسئلة التي تم وضع درجات لها إلا في "الاختبارات"، لذا فإن ضبطها على false سيتسبب في جميع وضع الدرجات، لكي تتم إزالتها من جميع الأسئلة.

لا تتوفّر إعدادات الاختبار إلا في واجهة مستخدم "نماذج Google" الجديدة. إنشاء نموذج أو اختبار يمنح النموذج إلى استخدام واجهة المستخدم الجديدة.

// Opens the Forms file by its URL. If you created your script from within a
// Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Makes the form a quiz.
form.setIsQuiz(true);

// Checks whether the form is a quiz or not and logs it to the console.
console.log(form.isQuiz());

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان يجب تفعيل ميزات الاختبار في النموذج false إذا لا.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setLimitOneResponsePerUser(enabled)

تحدِّد هذه السياسة ما إذا كان النموذج يسمح فقط برد واحد لكل مجيب. الإعداد التلقائي للنماذج الجديدة هو false في حال ضبط القيمة على true، لا يمكن للنص البرمجي إرسال الردود على النموذج في الكل.

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان يجب أن يسمح النموذج برد واحد فقط لكل مستجيب false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setProgressBar(enabled)

لتحديد ما إذا كان النموذج يحتوي على شريط تقدّم. الإعداد التلقائي للنماذج الجديدة هو false.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Displays the progress bar on the form.
form.setProgressBar(true);

// Checks whether the form has a progress bar and logs it to the console.
console.log(form.hasProgressBar());

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان النموذج يعرض شريط تقدّم false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setPublishingSummary(enabled)

تحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد إرسال أحد المستجيبين. النموذج. الإعداد التلقائي للنماذج الجديدة هو false.

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان يجب أن يعرض النموذج "الاطّلاع على الردود السابقة" رابط؛ false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setRequireLogin(requireLogin)

لتحديد ما إذا كان النموذج يتطلب من المستجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو النطاق الفرعي قبل الرد. الإعداد التلقائي للنماذج الجديدة هو false ما لم يتم استخدام نطاق. يقوم المشرف بتغيير الإعداد الافتراضي.

لا تتوفّر هذه الميزة إلا للنماذج التي أنشأها مستخدمو Google Workspace. مستخدمو حسابات أخرى نوعًا من حسابات Google لتسجيل الدخول.

// Opens the Forms file by its URL. If you created your script from within
// a Google Forms file, you can use FormApp.getActiveForm() instead.
// TODO(developer): Replace the URL with your own.
const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit');

// Sets the form so that users must log in to their Google Workspace account.
form.setRequireLogin(true);

// Checks whether the form requires login or not and logs it to the console.
console.log(form.requiresLogin());

المعلمات

الاسمالنوعالوصف
requireLoginBooleantrue إذا كان النموذج يتطلّب من المستخدمين تسجيل الدخول false إذا كان لا.

الإرجاع

Form — النموذج الحالي (للسلسلة)

التفويض

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

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

setShowLinkToRespondAgain(enabled)

لضبط ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد إكمال المجيب النموذج. الإعداد التلقائي للنماذج الجديدة هو true.

المعلمات

الاسمالنوعالوصف
enabledBooleantrue إذا كان يجب أن يعرض النموذج "إرسال رد آخر" رابط؛ false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setShuffleQuestions(shuffle)

لتحديد ما إذا كان سيتم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا.

المعلمات

الاسمالنوعالوصف
shuffleBooleantrue إذا كان ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا؛ false إذا لم يكن كذلك.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

setTitle(title)

لضبط عنوان النموذج.

المعلمات

الاسمالنوعالوصف
titleStringتمثّل هذه السمة العنوان الجديد للنموذج.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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

shortenFormUrl(url)

تحوِّل عنوان URL الطويل الخاص بنموذج إلى عنوان URL مختصر. يعرض استثناءات إذا لم يكن عنوان URL الطويل ينتمي إلى نماذج Google.

المعلمات

الاسمالنوعالوصف
urlStringعنوان URL المطلوب اختصاره.

الإرجاع

String — عنوان URL بالتنسيق http://goo.gl/forms/1234

التفويض

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

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

submitGrades(responses)

يؤدي هذا الخيار إلى إرسال الدرجات لنماذج الردود المقدَّمة في النموذج.

إذا كان الرمز يحتوي على عامل تشغيل "onFormSubmit"، سيتم الاتصال بـ submitGrades(). يؤدي إلى تشغيل شرط onFormSubmit ويؤدي إلى تكرار حلقة لانهائية. لمنع حلقة لانهائية، يمكنك إضافة رمز يتحقّق مما إذا كانت الدرجات متوفّرة حاليًا قبل طلب الرقم submitGrades().

المعلمات

الاسمالنوعالوصف
responsesFormResponse[]مصفوفة من جميع ردود النموذج.

الإرجاع

Form — هذا Form، للسلسلة.

التفويض

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

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