نموذج يحتوي على خصائص وعناصر عامة تتضمن الخصائص العنوان والإعدادات ومكان
والردود عليها. تتضمن العناصر عناصر الأسئلة مثل مربعات الاختيار أو عناصر الراديو، بينما يؤدي التخطيط
تشير العناصر إلى أشياء مثل فواصل الصفحات. يمكن الوصول إلى النماذج أو إنشاؤها من 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
. إذا كان المستخدم قد
في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدِم الذي تريد إضافته. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(user)
يؤدي هذا الإجراء إلى إضافة المستخدم المحدّد إلى قائمة محرّري Form
. إذا كان المستخدم قد
في قائمة المشاهدين، تؤدي هذه الطريقة إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إضافته |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditors(emailAddresses)
لإضافة مصفوفة معيّنة من المستخدمين إلى قائمة المحرِّرين في Form
إذا كانت أي من
كان المستخدمون مدرجين بالفعل في قائمة المشاهدين، تُدرجهم هذه الطريقة في قائمة المشاهدين
المشاهدون.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
emailAddresses | String[] | مصفوفة من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتها. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
الإرجاع
Boolean
— true
إذا كان النموذج يعرض رسالة "تعديل ردك" رابط؛ 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);
الإرجاع
Boolean
— true
إذا كان النموذج يجمع عناوين البريد الإلكتروني 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()
يؤدي هذا الإجراء إلى حذف جميع الردود المُرسَلة من مخزن ردود النموذج. لا يؤدي هذا الإجراء إلى حذف نسخ من الردود المخزنة في وجهة استجابة خارجية (مثل جدول بيانات)، ولكنها محو عرض ملخص النموذج.
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
index | Integer | فهرس العنصر بين جميع العناصر في النموذج. |
الرميات
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); }
المعلمات
الاسم | النوع | الوصف |
---|---|---|
item | Item | العنصر المطلوب حذفه. |
الرميات
Error
: إذا لم يتوفّر العنصر في النموذج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteResponse(responseId)
حذف رد واحد من مخزن ردود النموذج. لا تحذف هذه الطريقة نُسخًا من
الردود المخزنة في وجهة رد خارجية (مثل جدول بيانات)، ولكنها تزيل
الرد من عرض الملخص للنموذج. يمكن استرداد رقم تعريف الردّ باستخدام FormResponse.getId()
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
responseId | String | رقم تعريف الردّ على النموذج المطلوب حذفه |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | Integer | معرّف السلعة |
الإرجاع
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
itemType | ItemType | نوع العناصر المطلوب استردادها. |
الإرجاع
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()
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
responseId | String | رقم تعريف الردّ على النموذج. |
الإرجاع
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)
الحصول على مصفوفة من جميع ردود النموذج بعد تاريخ ووقت محدّدين
المعلمات
الاسم | النوع | الوصف |
---|---|---|
timestamp | Date | أقرب تاريخ ووقت يجب عرض الردود على النموذج خلاله. |
الإرجاع
FormResponse[]
— قائمة الردود على النموذج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getShuffleQuestions()
تحدد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج يتم عشوائيًا.
الإرجاع
Boolean
— true
إذا تم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا
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
، لن يتمكن النص البرمجي من إرسال ردود على النموذج على الإطلاق.
الإرجاع
Boolean
— true
إذا كان النموذج يسمح فقط برد واحد لكل مستجيب 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());
الإرجاع
Boolean
— true
إذا كان النموذج يعرض شريط تقدم false
إذا لم يتم تحديده.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasRespondAgainLink()
تحدِّد ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد المجيب يكمل النموذج.
// 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());
الإرجاع
Boolean
— true
إذا كان النموذج يعرض الرسالة "إرسال رد آخر" رابط؛ 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);
الإرجاع
Boolean
— true
إذا كان النموذج يقبل الردود 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);
الإرجاع
Boolean
— true
إذا كان النموذج يعرض الرسالة "الاطّلاع على الردود السابقة" رابط؛ 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());
الإرجاع
Boolean
— true
إذا كان النموذج يقبل الردود 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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
from | Integer | الفهرس الحالي للسلعة بين جميع العناصر في النموذج. |
to | Integer | الفهرس الجديد للعنصر بين جميع العناصر في النموذج. |
الإرجاع
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
item | Item | العنصر المطلوب نقله. |
toIndex | Integer | الفهرس الجديد للعنصر بين جميع العناصر في النموذج. |
الإرجاع
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();
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(emailAddress)
إزالة المستخدم المحدّد من قائمة محرِّري Form
هذه الطريقة لا
منع المستخدمين من الوصول إلى "Form
" إذا كانوا ينتمون إلى فئة من المستخدمين لديهم
إذن بالوصول العام: على سبيل المثال، إذا تمت مشاركة Form
مع كامل
أو إذا كان Form
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، سيؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
emailAddress | String | عنوان البريد الإلكتروني للمستخدم المطلوب إزالته. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(user)
إزالة المستخدم المحدّد من قائمة محرِّري Form
هذه الطريقة لا
منع المستخدمين من الوصول إلى "Form
" إذا كانوا ينتمون إلى فئة من المستخدمين لديهم
إذن بالوصول العام: على سبيل المثال، إذا تمت مشاركة Form
مع كامل
أو إذا كان Form
في مساحة تخزين سحابي مشتركة يمكن للمستخدم الوصول إليها.
وبالنسبة إلى ملفات Drive، سيؤدي ذلك أيضًا إلى إزالة المستخدم من قائمة المشاهدين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
user | User | تمثيل للمستخدم المطلوب إزالته |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
الإرجاع
Boolean
— true
إذا كان النموذج يتطلب من المستخدمين تسجيل الدخول 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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان على النموذج قبول الردود false إذا كان لا ينبغي ذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان يجب أن يعرض النموذج "تعديل ردّك" رابط؛ false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
collect | Boolean | true إذا كان يجب أن يجمع النموذج عناوين البريد الإلكتروني false إذا كان
لا. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | String | هي رسالة التأكيد الجديدة للنموذج. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
message | String | الرسالة التي يتم عرضها إذا كان النموذج لا يقبل الردود. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDescription(description)
لضبط وصف النموذج.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
description | String | الوصف الجديد للنموذج |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDestination(type, id)
تحدِّد هذه السياسة الوجهة التي يتم حفظ الردود على النموذج فيها. جميع النماذج، بما في ذلك تلك التي لا تعيين وجهة بشكل صريح، يُرجى حفظ نسخة من الردود في مخزن الردود.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
type | DestinationType | نوع وجهة الرد على النموذج |
id | String | رقم تعريف وجهة الرد على النموذج |
الإرجاع
الرميات
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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان يجب تفعيل ميزات الاختبار في النموذج false إذا
لا. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLimitOneResponsePerUser(enabled)
تحدِّد هذه السياسة ما إذا كان النموذج يسمح فقط برد واحد لكل مجيب. الإعداد التلقائي للنماذج الجديدة هو
false
في حال ضبط القيمة على true
، لا يمكن للنص البرمجي إرسال الردود على النموذج في
الكل.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان يجب أن يسمح النموذج برد واحد فقط لكل مستجيب false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان النموذج يعرض شريط تقدّم false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPublishingSummary(enabled)
تحدِّد هذه السياسة ما إذا كان النموذج يعرض رابطًا لعرض ملخّص الردود بعد إرسال أحد المستجيبين.
النموذج. الإعداد التلقائي للنماذج الجديدة هو false
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان يجب أن يعرض النموذج "الاطّلاع على الردود السابقة" رابط؛ false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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());
المعلمات
الاسم | النوع | الوصف |
---|---|---|
requireLogin | Boolean | true إذا كان النموذج يتطلّب من المستخدمين تسجيل الدخول false إذا كان
لا. |
الإرجاع
Form
— النموذج الحالي (للسلسلة)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShowLinkToRespondAgain(enabled)
لضبط ما إذا كان النموذج يعرض رابطًا لإرسال رد آخر بعد إكمال المجيب
النموذج. الإعداد التلقائي للنماذج الجديدة هو true
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
enabled | Boolean | true إذا كان يجب أن يعرض النموذج "إرسال رد آخر" رابط؛ false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShuffleQuestions(shuffle)
لتحديد ما إذا كان سيتم ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
shuffle | Boolean | true إذا كان ترتيب الأسئلة في كل صفحة من النموذج
عشوائيًا؛ false إذا لم يكن كذلك. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان النموذج.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | تمثّل هذه السمة العنوان الجديد للنموذج. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
shortenFormUrl(url)
تحوِّل عنوان URL الطويل الخاص بنموذج إلى عنوان URL مختصر. يعرض استثناءات إذا لم يكن عنوان URL الطويل ينتمي إلى نماذج Google.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان 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()
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
responses | FormResponse[] | مصفوفة من جميع ردود النموذج. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms