تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Form

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

// Open a form by ID and create a new spreadsheet.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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`	تُضيف هذه السمة عنصر سؤال جديد يتيح للمستجيب اختيار خيار واحد من قائمة أزرار radio buttons أو حقل اختياري "غير ذلك".
`addPageBreakItem()`	`PageBreakItem`	تُضيف عنصر تنسيق جديدًا يحدِّد بداية صفحة.
`addParagraphTextItem()`	`ParagraphTextItem`	تُضيف عنصر سؤال جديد يسمح للمستجيب بإدخال مجموعة من النصوص.
`addRatingItem()`	`RatingItem`	تُلحق عنصر سؤال جديد يتيح للمجيب تقديم تقييم.
`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`.
`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`	لضبط ما إذا كان النموذج سيعرض رابطًا لعرض ملخّص للردود بعد إرسال أحد المجيبين النموذج.
`setShowLinkToRespondAgain(enabled)`	`Form`	لضبط ما إذا كان النموذج سيعرض رابطًا لإرسال ردّ آخر بعد إكمال المستجيب النموذج.
`setShuffleQuestions(shuffle)`	`Form`	لتحديد ما إذا كان ترتيب الأسئلة في كل صفحة من النموذج عشوائيًا
`setTitle(title)`	`Form`	لضبط عنوان النموذج
`shortenFormUrl(url)`	`String`	لتحويل عنوان URL طويل لنموذج إلى عنوان URL قصير
`submitGrades(responses)`	`Form`	تُرسِل الدرجات لـ FormResponses المحدّدة.

الطرق المتوقّفة

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`requiresLogin()`	`Boolean`	يحدِّد ما إذا كان النموذج يطلب من المجيبين تسجيل الدخول إلى حساب في النطاق نفسه أو النطاق الفرعي نفسه قبل الردّ.
`setRequireLogin(requireLogin)`	`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();

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`	عنوان البريد الإلكتروني للمستخدم الذي تريد إضافته

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`addEditor(user)`

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

المعلمات

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

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`addEditors(emailAddresses)`

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

المعلمات

الاسم	النوع	الوصف
`emailAddresses`	`String[]`	صفيف من عناوين البريد الإلكتروني للمستخدمين المطلوب إضافتهم

الإرجاع

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()`

تُضيف هذه السمة عنصر سؤال جديد يتيح للمستجيب اختيار خيار واحد من قائمة أزرار radio buttons أو حقل اختياري "غير ذلك".

// 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

`addRatingItem()`

تُلحق عنصر سؤال جديد يتيح للمجيب تقديم تقييم.

// 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 rating item.
const item = form.addRatingItem();

الإرجاع

RatingItem: العنصر الذي تم إنشاؤه حديثًا

التفويض

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

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()`

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

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`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`	رقم تعريف الردّ على النموذج المطلوب حذفه

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`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 استثناءً في برمجة النصّ البرمجي إذا كان فهرس 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();

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`removeEditor(emailAddress)`

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

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

المعلمات

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

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`removeEditor(user)`

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

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

المعلمات

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

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`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` إذا كان لا يقبلها

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان من المفترض أن يعرض النموذج رابط "تعديل ردّك"، `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);

المعلمات

الاسم	النوع	الوصف
`collect`	`Boolean`	`true` إذا كان النموذج سيجمع عناوين البريد الإلكتروني، `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);

المعلمات

الاسم	النوع	الوصف
`message`	`String`	رسالة التأكيد الجديدة للنموذج

الإرجاع

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

المعلمات

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

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setDescription(description)`

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

المعلمات

الاسم	النوع	الوصف
`description`	`String`	الوصف الجديد للنموذج

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setDestination(type, id)`

لضبط الوجهة التي يتم حفظ ردود النماذج فيها تُحفظ جميع النماذج، بما في ذلك النماذج التي ليس لها وجهة محدّدة صراحةً، في نسخة من الردود في مستودع الردود الخاص بالنموذج.

المعلمات

الاسم	النوع	الوصف
`type`	`DestinationType`	نوع وجهة الردّ في النموذج
`id`	`String`	رقم تعريف وجهة الردّ على النموذج

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان يجب تفعيل ميزات الاختبار للنموذج، `false` إذا لم يكن الأمر كذلك.

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setLimitOneResponsePerUser(enabled)`

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان النموذج يسمح بتقديم رد واحد فقط لكل مستجيب، `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());

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان النموذج يعرض شريط تقدّم، `false` إذا لم يكن يعرضه

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setPublishingSummary(enabled)`

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان من المفترض أن يعرض النموذج رابط "عرض الردود السابقة"، `false` إذا لم يكن الأمر كذلك.

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setShowLinkToRespondAgain(enabled)`

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

المعلمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان من المفترض أن يعرض النموذج رابط "إرسال رد آخر"، `false` إذا لم يكن الأمر كذلك.

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setShuffleQuestions(shuffle)`

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

المعلمات

الاسم	النوع	الوصف
`shuffle`	`Boolean`	`true` إذا كان يجب ترتيب الأسئلة على كل صفحة من النموذج عشوائيًا، `false` إذا لم يكن الأمر كذلك.

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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

`setTitle(title)`

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

المعلمات

الاسم	النوع	الوصف
`title`	`String`	عنوان النموذج الجديد.

الإرجاع

Form — هذا الرمز Form، لإنشاء سلسلة.

التفويض

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

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)`

تُرسِل الدرجات لـ FormResponses المحدّدة.

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

المعلمات

الاسم	النوع	الوصف
`responses`	`FormResponse[]`	صفيف لجميع ردود النموذج

الإرجاع

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

الإرجاع

Boolean: true إذا كان النموذج يتطلّب من المستخدمين تسجيل الدخول، false إذا لم يكن الأمر كذلك

`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