فرمی که شامل ویژگیها و آیتمهای کلی است. ویژگیها شامل عنوان، تنظیمات و محل ذخیره پاسخها میشوند. آیتمها شامل آیتمهای پرسشی مانند چکباکسها یا آیتمهای رادیویی هستند، در حالی که آیتمهای طرحبندی به مواردی مانند پرش به صفحه اشاره دارند. فرمها را میتوان از طریق Form App دسترسی یا ایجاد کرد.
// 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());
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
add Checkbox Grid Item() | Checkbox Grid Item | یک آیتم سوال جدید اضافه میکند که به صورت شبکهای از ستونها و ردیفها ارائه میشود و به پاسخدهنده اجازه میدهد تا در هر ردیف، چندین گزینه را از بین مجموعهای از کادرهای انتخاب انتخاب کند. |
add Checkbox Item() | Checkbox Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد یک یا چند کادر انتخاب و همچنین یک فیلد اختیاری "سایر" را انتخاب کند. |
add Date Item() | Date Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد تاریخ را مشخص کند. |
add Date Time Item() | Date Time Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد تاریخ و زمان را مشخص کند. |
add Duration Item() | Duration Item | یک آیتم سؤالی جدید اضافه میکند که به پاسخدهنده اجازه میدهد مدت زمان را مشخص کند. |
add Editor(emailAddress) | Form | کاربر داده شده را به لیست ویرایشگرهای Form اضافه میکند. |
add Editor(user) | Form | کاربر داده شده را به لیست ویرایشگرهای Form اضافه میکند. |
add Editors(emailAddresses) | Form | آرایهی داده شده از کاربران را به لیست ویرایشگرهای Form اضافه میکند. |
add Grid Item() | Grid Item | یک آیتم سوال جدید اضافه میکند که به صورت شبکهای از ستونها و ردیفها ارائه میشود و به پاسخدهنده اجازه میدهد تا در هر ردیف، یک گزینه را از بین دنبالهای از دکمههای رادیویی انتخاب کند. |
add Image Item() | Image Item | یک آیتم طرحبندی جدید اضافه میکند که یک تصویر را نمایش میدهد. |
add List Item() | List Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد از یک لیست کشویی، یک گزینه را انتخاب کند. |
add Multiple Choice Item() | Multiple Choice Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد از فهرست دکمههای رادیویی یا یک فیلد اختیاری «سایر» یک گزینه را انتخاب کند. |
add Page Break Item() | Page Break Item | یک آیتم طرحبندی جدید اضافه میکند که شروع یک صفحه را مشخص میکند. |
add Paragraph Text Item() | Paragraph Text Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد یک بلوک متن وارد کند. |
add Published Reader(emailAddress) | Form | کاربر داده شده را به لیست پاسخ دهندگان Form اضافه میکند. |
add Published Reader(user) | Form | کاربر داده شده را به لیست پاسخ دهندگان Form اضافه میکند. |
add Published Readers(emailAddresses) | Form | آرایهی داده شده از کاربران را به لیست پاسخدهندگان Form اضافه میکند. |
add Rating Item() | Rating Item | یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد امتیاز بدهد. |
add Scale Item() | Scale Item | یک آیتم سؤالی جدید اضافه میکند که به پاسخدهنده اجازه میدهد از بین مجموعهای از دکمههای رادیویی که شمارهگذاری شدهاند، یک گزینه را انتخاب کند. |
add Section Header Item() | Section Header Item | یک آیتم طرحبندی جدید اضافه میکند که به صورت بصری شروع یک بخش را نشان میدهد. |
add Text Item() | Text Item | یک آیتم سؤالی جدید اضافه میکند که به پاسخدهنده اجازه میدهد یک خط متن وارد کند. |
add Time Item() | Time Item | یک آیتم سؤالی جدید اضافه میکند که به پاسخدهنده اجازه میدهد زمانی از روز را مشخص کند. |
add Video Item() | Video Item | یک آیتم طرحبندی جدید اضافه میکند که یک ویدیو را نمایش میدهد. |
can Edit Response() | Boolean | تعیین میکند که آیا فرم پس از ارسال پاسخ، پیوندی برای ویرایش آن نمایش دهد یا خیر. |
collects Email() | Boolean | تعیین میکند که آیا فرم، آدرسهای ایمیل پاسخدهندگان را جمعآوری میکند یا خیر. |
create Response() | Form Response | یک پاسخ جدید به فرم ایجاد میکند. |
delete All Responses() | Form | تمام پاسخهای ارسالی را از مخزن پاسخ فرم حذف میکند. |
delete Item(index) | void | آیتمی را که در یک اندیس مشخص از بین تمام آیتمهای موجود در فرم قرار دارد، حذف میکند. |
delete Item(item) | void | مورد داده شده را حذف میکند. |
delete Response(responseId) | Form | یک پاسخ واحد را از مخزن پاسخ فرم حذف میکند. |
get Confirmation Message() | String | پیام تأیید فرم را دریافت میکند. |
get Custom Closed Form Message() | String | پیام سفارشیای را که در صورت عدم پذیرش پاسخها توسط فرم نمایش داده میشود، یا در صورت عدم تنظیم پیام سفارشی، یک رشته خالی را برمیگرداند. |
get Description() | String | توضیحات فرم را دریافت میکند. |
get Destination Id() | String | شناسه (ID) مقصد پاسخ فرم را دریافت میکند. |
get Destination Type() | Destination Type | نوع مقصد پاسخ فرم را دریافت میکند. |
get Edit Url() | String | آدرس اینترنتی (URL) مورد استفاده برای دسترسی به حالت ویرایش فرم را برمیگرداند. |
get Editors() | User[] | لیست ویرایشگرهای این Form را دریافت میکند. |
get Id() | String | شناسه فرم را دریافت میکند. |
get Item By Id(id) | Item |null | آیتم را با شناسه (ID) داده شده دریافت میکند. |
get Items() | Item[] | آرایهای از تمام آیتمهای موجود در فرم را دریافت میکند. |
get Items(itemType) | Item[] | آرایهای از تمام آیتمهای یک نوع داده شده را دریافت میکند. |
get Published Readers() | User[] | لیست پاسخدهندگان به این Form را دریافت میکند. |
get Published Url() | String | آدرس اینترنتی (URL) مورد استفاده برای پاسخ به فرم را دریافت میکند. |
get Response(responseId) | Form Response | بر اساس شناسه پاسخ، یک پاسخ واحد از فرم دریافت میکند. |
get Responses() | Form Response[] | آرایهای از تمام پاسخهای فرم را دریافت میکند. |
get Responses(timestamp) | Form Response[] | آرایهای از تمام پاسخهای فرم را پس از تاریخ و زمان مشخص شده دریافت میکند. |
get Shuffle Questions() | Boolean | تعیین میکند که آیا ترتیب سوالات در هر صفحه از فرم تصادفی است یا خیر. |
get Summary Url() | String | URL ای را که می توان برای مشاهده خلاصه ای از پاسخ های فرم استفاده کرد، دریافت می کند. |
get Title() | String | عنوان فرم را دریافت میکند. |
has Limit One Response Per User() | Boolean | تعیین میکند که آیا فرم فقط به ازای هر پاسخدهنده یک پاسخ را مجاز میداند یا خیر. |
has Progress Bar() | Boolean | تعیین میکند که آیا فرم نوار پیشرفت را نمایش میدهد یا خیر. |
has Respond Again Link() | Boolean | تعیین میکند که آیا فرم، پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای ارسال پاسخ دیگر نمایش دهد یا خیر. |
is Accepting Responses() | Boolean | تعیین میکند که آیا فرم در حال حاضر پاسخها را میپذیرد یا خیر. |
is Published() | Boolean | مشخص میکند که آیا فرم منتشر شده است یا خیر. |
is Publishing Summary() | Boolean | تعیین میکند که آیا فرم، پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای مشاهده خلاصه پاسخها نمایش دهد یا خیر. |
is Quiz() | Boolean | مشخص میکند که آیا فرم، یک آزمون است یا خیر. |
move Item(from, to) | Item | یک آیتم را در یک اندیس مشخص از بین تمام آیتمهای موجود در فرم، به اندیس مشخص دیگری منتقل میکند. |
move Item(item, toIndex) | Item | یک آیتم داده شده را از بین تمام آیتمهای موجود در فرم، به یک اندیس داده شده منتقل میکند. |
remove Destination() | Form | فرم را از مقصد پاسخ فعلیاش جدا میکند. |
remove Editor(emailAddress) | Form | کاربر داده شده را از لیست ویرایشگرهای Form حذف میکند. |
remove Editor(user) | Form | کاربر داده شده را از لیست ویرایشگرهای Form حذف میکند. |
remove Published Reader(emailAddress) | Form | کاربر داده شده را از لیست پاسخ دهندگان Form حذف میکند. |
remove Published Reader(user) | Form | کاربر داده شده را از لیست پاسخ دهندگان Form حذف میکند. |
set Accepting Responses(enabled) | Form | تعیین میکند که آیا فرم در حال حاضر پاسخها را میپذیرد یا خیر. |
set Allow Response Edits(enabled) | Form | تعیین میکند که آیا فرم پس از ارسال پاسخ، پیوندی برای ویرایش آن نمایش دهد یا خیر. |
set Collect Email(collect) | Form | تعیین میکند که آیا فرم، آدرسهای ایمیل پاسخدهندگان را جمعآوری کند یا خیر. |
set Confirmation Message(message) | Form | پیام تأیید فرم را تنظیم میکند. |
set Custom Closed Form Message(message) | Form | تنظیم میکند که در صورت عدم پذیرش پاسخها توسط فرم، چه پیامی نمایش داده شود. |
set Description(description) | Form | توضیحات فرم را تنظیم میکند. |
set Destination(type, id) | Form | مقصدی را که پاسخهای فرم در آن ذخیره میشوند، تعیین میکند. |
set Is Quiz(enabled) | Form | مشخص میکند که آیا فرم یک آزمون است یا خیر. |
set Limit One Response Per User(enabled) | Form | تعیین میکند که آیا فرم فقط به ازای هر پاسخدهنده یک پاسخ میدهد یا خیر. |
set Progress Bar(enabled) | Form | تعیین میکند که آیا فرم دارای نوار پیشرفت باشد یا خیر. |
set Published(enabled) | Form | مشخص میکند که آیا فرم منتشر شده است یا خیر. |
set Publishing Summary(enabled) | Form | تعیین میکند که آیا فرم، پس از ارسال فرم توسط پاسخدهنده، پیوندی برای مشاهده خلاصه پاسخها نمایش دهد یا خیر. |
set Show Link To Respond Again(enabled) | Form | تعیین میکند که آیا فرم، پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای ارسال پاسخ دیگر نمایش دهد یا خیر. |
set Shuffle Questions(shuffle) | Form | تعیین میکند که آیا ترتیب سوالات در هر صفحه از فرم تصادفی باشد یا خیر. |
set Title(title) | Form | عنوان فرم را تنظیم میکند. |
shorten Form Url(url) | String | یک URL طولانی برای یک فرم را به یک URL کوتاه تبدیل میکند. |
submit Grades(responses) | Form | نمرات مربوط به FormResponses داده شده را ارسال میکند. |
supports Advanced Responder Permissions() | Boolean | تعیین میکند که آیا فرم از انتشار پشتیبانی میکند یا خیر. |
مستندات دقیق
add Checkbox Grid 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', ); // 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' ]);
بازگشت
Checkbox Grid Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Checkbox 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', ); // 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']);
بازگشت
Checkbox Item — مورد تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Date 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', ); // 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.');
بازگشت
Date Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Date Time 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', ); // 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);
بازگشت
Date Time Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Duration 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', ); // 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);
بازگشت
Duration Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Editor(emailAddress)
کاربر داده شده را به لیست ویرایشگران Form اضافه میکند. اگر کاربر از قبل در لیست بینندگان یا پاسخدهندگان باشد، این متد کاربر را از لیست خارج میکند.
// 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 editor to the form. // TODO(developer): replace the emailAddress. form.addEditor('editor@uni.edu');
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Address | String | آدرس ایمیل کاربر برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Editor(user)
کاربر داده شده را به لیست ویرایشگران Form اضافه میکند. اگر کاربر از قبل در لیست بینندگان یا پاسخدهندگان باشد، این متد کاربر را از لیست خارج میکند.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the editors from the old form. const users = oldForm.getEditors(); // Creates a new form. const newForm = FormApp.create('New form'); // Adds the editors to a new form. users.forEach(user => newForm.addEditor(user));
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
user | User | نمایشی از کاربر برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Editors(emailAddresses)
آرایه داده شده از کاربران را به لیست ویرایشگرهای Form اضافه میکند. اگر هر یک از کاربران از قبل در لیست بینندگان باشند، این متد آنها را از لیست بینندگان خارج میکند.
// 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 editors to the form. // TODO(developer): replace the emailAddress. form.addPublishedReaders(['editor1@uni.edu', 'editor2@uni.edu']);
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Addresses | String[] | آرایهای از آدرسهای ایمیل کاربران برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Grid 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', ); // 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' ]);
بازگشت
Grid Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Image 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', ); // 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);
بازگشت
Image Item - آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add List 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', ); // 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')]);
بازگشت
List Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Multiple Choice 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', ); // 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]);
بازگشت
Multiple Choice Item - مورد تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Page Break 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', ); // 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);
بازگشت
Page Break Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Paragraph Text Item()
یک آیتم سوال جدید اضافه میکند که به پاسخدهنده اجازه میدهد یک بلوک متن وارد کند.
// 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?');
بازگشت
Paragraph Text Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Published Reader(emailAddress)
کاربر داده شده را به لیست پاسخ دهندگان Form اضافه میکند. اگر کاربر از قبل در لیست ویرایشگران یا بینندگان باشد، این متد هیچ تاثیری ندارد.
// 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 responder to the form. // TODO(developer): replace the emailAddress. form.addPublishedReader('responder@uni.edu');
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Address | String | آدرس ایمیل کاربر برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Published Reader(user)
کاربر داده شده را به لیست پاسخ دهندگان Form اضافه میکند. اگر کاربر از قبل در لیست ویرایشگران یا بینندگان باشد، این متد هیچ تاثیری ندارد.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const oldForm = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the responders from the old form. const users = oldForm.getPublishedReaders(); // Creates a new form. const newForm = FormApp.create('New form'); // Adds the responders to a new form. users.forEach(user => newForm.addPublishedReader(user));
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
user | User | نمایشی از کاربر برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Published Readers(emailAddresses)
آرایهی داده شده از کاربران را به لیست پاسخدهندگان Form اضافه میکند. اگر کاربر از قبل در لیست ویرایشگران یا بینندگان باشد، این متد هیچ تاثیری ندارد.
// 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 responders to the form. // TODO(developer): replace the emailAddress. form.addPublishedReaders(['responder1@uni.edu', 'responder2@uni.edu']);
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Addresses | String[] | آرایهای از آدرسهای ایمیل کاربران برای اضافه کردن. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Rating 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', ); // Adds the rating item. const item = form.addRatingItem();
بازگشت
Rating Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Scale 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', ); // 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');
بازگشت
Scale Item - آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Section Header 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', ); // 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');
بازگشت
Section Header Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Text 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', ); // Adds a single-line text item. const item = form.addTextItem(); // Sets the title to 'What is your name?' item.setTitle('What is your name?');
بازگشت
Text Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Time 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', ); // 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?');
بازگشت
Time Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
add Video 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', ); // 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);
بازگشت
Video Item — آیتم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
can Edit Response()
تعیین میکند که آیا فرم پس از ارسال پاسخ، پیوندی برای ویرایش آن نمایش دهد یا خیر.
صرف نظر از این تنظیم، متد Form Response.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
collects Email()
تعیین میکند که آیا فرم، آدرسهای ایمیل پاسخدهندگان را جمعآوری میکند یا خیر.
// 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
create Response()
یک پاسخ جدید به فرم ایجاد میکند. برای پاسخ به یک آیتم سوال، یک Item Response از آیتم ایجاد کنید، سپس با فراخوانی Form Response.withItemResponse(response) آن را به این پاسخ فرم پیوست کنید. برای ذخیره پاسخ مونتاژ شده، Form Response.submit() را فراخوانی کنید.
بازگشت
Form Response - پاسخ فرم تازه ایجاد شده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
delete All Responses()
تمام پاسخهای ارسالی را از مخزن پاسخ فرم حذف میکند. این روش کپیهای پاسخهای ذخیره شده در یک مقصد پاسخ خارجی (مانند یک صفحه گسترده) را حذف نمیکند، اما نمای خلاصه فرم را پاک میکند.
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
delete Item(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
delete Item(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
delete Response(responseId)
یک پاسخ واحد را از مخزن پاسخ فرم حذف میکند. این متد کپیهای پاسخهای ذخیره شده در یک مقصد پاسخ خارجی (مانند یک صفحه گسترده) را حذف نمیکند، اما پاسخ را از نمای خلاصه فرم حذف میکند. شناسه پاسخ را میتوان با Form Response.getId() بازیابی کرد.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
response Id | String | شناسهی پاسخ فرم برای حذف. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Confirmation 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 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
get Custom Closed Form 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 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
get Description()
توضیحات فرم را دریافت میکند.
// 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
get Destination Id()
شناسه (ID) مقصد پاسخ فرم را دریافت میکند.
// 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
get Destination Type()
نوع مقصد پاسخ فرم را دریافت میکند.
// 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);
بازگشت
Destination Type — نوع مقصد پاسخ فرم.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Edit Url()
آدرس اینترنتی (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
get Editors()
get Id()
شناسه فرم را دریافت میکند.
// 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
get Item By Id(id)
آیتم را با شناسه (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 — آیتمی با شناسهی داده شده، یا اگر آیتم در فرم وجود نداشته باشد، null .
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Items()
آرایهای از تمام آیتمهای موجود در فرم را دریافت میکند.
// 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
get Items(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);
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
item Type | Item Type | نوع اقلامی که باید بازیابی شوند. |
بازگشت
Item[] — آرایهای از تمام آیتمهای از آن نوع.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Published Readers()
لیست پاسخدهندگان به این Form را دریافت میکند.
// 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 responders for the form. const users = form.getPublishedReaders(); users.forEach(user => console.log(user.getEmail()));
بازگشت
User[] — آرایهای از کاربران با مجوز پاسخدهنده.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Published Url()
آدرس اینترنتی (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
get Response(responseId)
یک پاسخ فرم واحد را بر اساس شناسه پاسخ آن دریافت میکند. شناسههای پاسخ را میتوان از Form Response.getId() بازیابی کرد.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
response Id | String | شناسهی پاسخ فرم. |
بازگشت
Form Response - پاسخ فرم.
پرتابها
Error - اگر پاسخ وجود نداشته باشد
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Responses()
آرایهای از تمام پاسخهای فرم را دریافت میکند.
بازگشت
Form Response[] — آرایهای از تمام پاسخهای فرم.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Responses(timestamp)
آرایهای از تمام پاسخهای فرم را پس از تاریخ و زمان مشخص شده دریافت میکند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
timestamp | Date | زودترین تاریخ و زمانی که پاسخهای فرم باید برگردانده شوند. |
بازگشت
Form Response[] — فهرست پاسخهای فرم.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Shuffle Questions()
تعیین میکند که آیا ترتیب سوالات در هر صفحه از فرم تصادفی است یا خیر.
بازگشت
Boolean - اگر ترتیب سوالات در هر صفحه از فرم تصادفی باشد، true ؛ در غیر این صورت، false .
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Summary Url()
URL ای را که میتوان برای مشاهده خلاصهای از پاسخهای فرم استفاده کرد، دریافت میکند. مگر اینکه set Publishing Summary(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 - آدرس اینترنتی برای مشاهده خلاصهای از پاسخها.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
get Title()
عنوان فرم را دریافت میکند.
// 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
has Limit One Response Per User()
تعیین میکند که آیا فرم فقط به ازای هر پاسخدهنده یک پاسخ میدهد یا خیر. اگر مقدار آن true باشد، اسکریپت نمیتواند به هیچ وجه پاسخهای فرم را ارسال کند.
بازگشت
Boolean - اگر فرم فقط یک پاسخ برای هر پاسخگو را مجاز بداند، true true و در غیر این صورت false برمیگرداند.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
has Progress Bar()
تعیین میکند که آیا فرم نوار پیشرفت را نمایش میدهد یا خیر.
// 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
has Respond Again Link()
تعیین میکند که آیا فرم، پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای ارسال پاسخ دیگر نمایش دهد یا خیر.
// 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
is Accepting Responses()
تعیین میکند که آیا فرم در حال حاضر پاسخها را میپذیرد یا خیر. این مقدار هنگام تغییر وضعیت انتشار فرم، بازنویسی میشود.
// 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
is Published()
مشخص میکند که آیا فرم منتشر شده است یا خیر.
این ویژگی فقط برای فرمهایی که از انتشار پشتیبانی میکنند در دسترس است. برای بررسی اینکه آیا فرم از انتشار پشتیبانی میکند یا خیر supports Advanced Responder Permissions() استفاده کنید.
// 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 whether the form is published or not and logs it to the console. console.log(form.isPublished());
بازگشت
Boolean - اگر فرم منتشر شده باشد، true و اگر منتشر نشده باشد false برمیگرداند.
پرتابها
Error — اگر در فرمهای پشتیبانی نشده فراخوانی شود.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
is Publishing Summary()
تعیین میکند که آیا فرم، پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای مشاهده خلاصه پاسخها نمایش دهد یا خیر.
// 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
is Quiz()
مشخص میکند که آیا فرم، یک آزمون است یا خیر.
// 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
move Item(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
move Item(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 | موردی که باید جابجا شود. |
to Index | Integer | شاخص جدید برای آیتم در بین تمام آیتمهای موجود در فرم. |
بازگشت
Item — موردی که منتقل شده است.
پرتابها
Error — اگر شاخص خارج از محدوده باشد.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
remove Destination()
فرم را از مقصد پاسخ فعلیاش جدا میکند. مقصد قبلی که پیوندش قطع شده، همچنان یک کپی از تمام پاسخهای قبلی را نگه میدارد. همه فرمها، از جمله آنهایی که مقصد مشخصی ندارند، یک کپی از پاسخها را در مخزن پاسخ فرم ذخیره میکنند . اگر فرم در حال حاضر مقصد پاسخی نداشته باشد، این متد هیچ تاثیری ندارد.
// 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
remove Editor(emailAddress)
کاربر داده شده را از لیست ویرایشگرهای Form حذف میکند. این روش، دسترسی کاربران به Form را در صورتی که به کلاسی از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمیکند - برای مثال، اگر Form با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Form در یک درایو مشترک باشد که کاربر میتواند به آن دسترسی داشته باشد.
برای فایلهای درایو، این کار کاربر را از فهرست بینندگان و پاسخدهندگان نیز حذف میکند.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Removes the editor from the form. // TODO(developer): replace the emailAddress. form.removeEditor('editor@uni.edu');
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Address | String | آدرس ایمیل کاربر برای حذف. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
remove Editor(user)
کاربر داده شده را از لیست ویرایشگرهای Form حذف میکند. این روش، دسترسی کاربران به Form را در صورتی که به کلاسی از کاربران با دسترسی عمومی تعلق داشته باشند، مسدود نمیکند - برای مثال، اگر Form با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Form در یک درایو مشترک باشد که کاربر میتواند به آن دسترسی داشته باشد.
برای فایلهای درایو، این کار کاربر را از فهرست مشاهدهکنندگان نیز حذف میکند.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the editors from the form. const users = form1.getEditors(); // Opens another form. // TODO(developer): Replace the URL with your own. const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit'); // Removes editors from the form. users.forEach(user => form2.removeEditor(user));
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
user | User | نمایندهای از کاربر که باید حذف شود. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
remove Published Reader(emailAddress)
کاربر داده شده را از لیست پاسخدهندگان به Form حذف میکند. این روش، دسترسی کاربران به Form را در صورتی که متعلق به کلاسی از کاربران با دسترسی عمومی باشند، مسدود نمیکند - برای مثال، اگر Form با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Form در یک درایو مشترک باشد که کاربر میتواند به آن دسترسی داشته باشد.
برای فایلهای درایو، این کار کاربر را از فهرست بینندگان و ویرایشگران نیز حذف میکند.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Removes the responders from the form. // TODO(developer): replace the emailAddress. form.removePublishedReader('responder1@uni.edu');
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
email Address | String | آدرس ایمیل کاربر برای حذف. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
remove Published Reader(user)
کاربر داده شده را از لیست پاسخدهندگان به Form حذف میکند. این روش، دسترسی کاربران به Form را در صورتی که متعلق به کلاسی از کاربران با دسترسی عمومی باشند، مسدود نمیکند - برای مثال، اگر Form با کل دامنه کاربر به اشتراک گذاشته شده باشد، یا اگر Form در یک درایو مشترک باشد که کاربر میتواند به آن دسترسی داشته باشد.
برای فایلهای درایو، این کار کاربر را از فهرست بینندگان و ویرایشگران نیز حذف میکند.
// Opens the Forms file by its URL. // TODO(developer): Replace the URL with your own. const form1 = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the responders from the form. const users = form1.getPublishedReaders(); // Opens another form. // TODO(developer): Replace the URL with your own. const form2 = FormApp.openByUrl('https://docs.google.com/forms/d/efg123456/edit'); // Removes responders from the form. users.forEach(user => form2.removePublishedReader(user));
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
user | User | نمایندهای از کاربر که باید حذف شود. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Accepting Responses(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 ، برای زنجیرهسازی.
پرتابها
Error — اگر در فرم منتشر نشده فعال باشد.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Allow Response Edits(enabled)
تنظیم میکند که آیا فرم پس از ارسال، پیوندی برای ویرایش پاسخ نمایش دهد یا خیر. پیشفرض برای فرمهای جدید false است.
صرف نظر از این تنظیم، متد Form Response.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
set Collect Email(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
set Confirmation Message(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
set Custom Closed Form Message(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
set Description(description)
توضیحات فرم را تنظیم میکند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
description | String | توضیحات جدید فرم. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Destination(type, id)
مقصدی را که پاسخهای فرم در آن ذخیره میشوند، تعیین میکند. همه فرمها، از جمله فرمهایی که صریحاً مقصدی برای آنها تعیین نشده است، یک کپی از پاسخها را در مخزن پاسخ فرم ذخیره میکنند .
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
type | Destination Type | نوع مقصد پاسخ فرم. |
id | String | شناسهی مقصد پاسخ فرم. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
پرتابها
Error - اگر شناسه مقصد داده شده نامعتبر باشد
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Is Quiz(enabled)
تعیین میکند که آیا فرم یک آزمون است یا خیر. مقدار پیشفرض برای فرمهای جدید false است.
سوالات نمرهدار فقط در آزمونها مجاز هستند، بنابراین تنظیم این گزینه روی 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', ); // 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
set Limit One Response Per User(enabled)
تعیین میکند که آیا فرم فقط به ازای هر پاسخدهنده یک پاسخ میدهد یا خیر. مقدار پیشفرض برای فرمهای جدید false است. اگر مقدار آن روی true تنظیم شود، اسکریپت نمیتواند به هیچ وجه پاسخهای فرم را ارسال کند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
enabled | Boolean | اگر فرم فقط اجازه یک پاسخ برای هر پاسخگو را بدهد، true و در غیر این صورت false . |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Progress Bar(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
set Published(enabled)
تنظیم میکند که آیا فرم منتشر شود یا خیر. مقدار پیشفرض برای فرمهای جدید true است.
این ویژگی فقط برای فرمهایی که از انتشار پشتیبانی میکنند در دسترس است. برای بررسی اینکه آیا فرم از انتشار پشتیبانی میکند یا خیر supports Advanced Responder Permissions() استفاده کنید.
برای اینکه یک فرم برای پاسخدهندگان قابل دسترسی باشد، باید منتشر شود. این متد جایگزین فراخوانیهای مربوط به set Accepting Responses(enabled) میشود.
// 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', ); // Publishes the form before sharing it. form.setPublished(true); // Checks whether the form is published or not and logs it to the console. console.log(form.isPublished());
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
enabled | Boolean | اگر فرم باید منتشر شود، true و در غیر این صورت false . |
بازگشت
Form — این Form ، برای زنجیرهسازی.
پرتابها
Error — اگر در فرمهای پشتیبانی نشده فراخوانی شود.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Publishing Summary(enabled)
تنظیم میکند که آیا فرم، پس از ارسال فرم توسط پاسخدهنده، پیوندی برای مشاهده خلاصه پاسخها نمایش دهد یا خیر. پیشفرض برای فرمهای جدید false است.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
enabled | Boolean | اگر فرم باید پیوند «مشاهده پاسخهای قبلی» را نمایش دهد، true و در غیر این صورت false . |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Show Link To Respond Again(enabled)
تنظیم میکند که آیا فرم پس از تکمیل فرم توسط پاسخدهنده، پیوندی برای ارسال پاسخ دیگر نمایش دهد یا خیر. پیشفرض برای فرمهای جدید true است.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
enabled | Boolean | اگر فرم باید پیوند «ارسال پاسخ دیگر» را نمایش دهد، true و در غیر این صورت false . |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Shuffle Questions(shuffle)
تعیین میکند که آیا ترتیب سوالات در هر صفحه از فرم تصادفی باشد یا خیر.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
shuffle | Boolean | اگر ترتیب سوالات در هر صفحه از فرم باید تصادفی باشد، true ؛ در غیر این صورت، false . |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
set Title(title)
عنوان فرم را تنظیم میکند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
title | String | عنوان جدید فرم. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
shorten Form Url(url)
یک URL طولانی برای یک فرم را به یک URL کوتاه تبدیل میکند. اگر URL طولانی متعلق به فرمهای گوگل نباشد، استثنا ایجاد میکند.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
url | String | آدرس اینترنتی (URL) برای کوتاه کردن. |
بازگشت
String - یک URL به شکل http://goo.gl/forms/1234 .
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
submit Grades(responses)
نمرات مربوط به FormResponses داده شده را ارسال میکند.
اگر کد شما شامل یک تریگر on Form Submit باشد، فراخوانی submit Grades() باعث فعال شدن شرط on Form Submit و یک حلقه بینهایت ایجاد میکند. برای جلوگیری از حلقه بینهایت، کدی اضافه کنید که قبل از فراخوانی submit Grades() بررسی کند که آیا نمرات از قبل وجود دارند یا خیر.
پارامترها
| نام | نوع | توضیحات |
|---|---|---|
responses | Form Response[] | آرایهای از تمام پاسخهای فرم. |
بازگشت
Form — این Form ، برای زنجیرهسازی.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
supports Advanced Responder Permissions()
تعیین میکند که آیا فرم از قابلیت انتشار پشتیبانی میکند یا خیر. این متد برای تعیین اینکه آیا set Published(enabled) و is Published() و مجوزهای پاسخدهنده در دسترس هستند یا خیر، استفاده میشود.
// 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 whether the form supports publishing or not and logs it to the // console. console.log(form.supportsAdvancedResponderPermissions());
بازگشت
Boolean - اگر فرم از انتشار پشتیبانی کند، true و اگر پشتیبانی نکند false برمیگرداند.
مجوز
اسکریپتهایی که از این روش استفاده میکنند، نیاز به مجوز با یک یا چند مورد از حوزههای زیر دارند:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms