แบบฟอร์มที่มีพร็อพเพอร์ตี้และรายการโดยรวม พร็อพเพอร์ตี้มีชื่อ การตั้งค่า และตำแหน่ง
และจัดเก็บคำตอบไว้ รายการประกอบด้วยรายการคำถาม เช่น ช่องทำเครื่องหมายหรือรายการตัวเลือก ขณะที่เลย์เอาต์
รายการหมายถึงสิ่งต่างๆ เช่น ตัวแบ่งหน้า คุณสามารถเข้าถึงหรือสร้างแบบฟอร์มได้จาก FormApp
// Open a form by ID and create a new spreadsheet. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var ss = SpreadsheetApp.create('Spreadsheet Name'); // Update form properties via chaining. form.setTitle('Form Name') .setDescription('Description of form') .setConfirmationMessage('Thanks for responding!') .setAllowResponseEdits(true) .setAcceptingResponses(false); // Update the form's response destination. form.setDestination(FormApp.DestinationType.SPREADSHEET, ss.getId());
เมธอด
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
addCheckboxGridItem() | CheckboxGridItem | เพิ่มรายการคำถามใหม่ ซึ่งแสดงเป็นตารางกริดที่มีคอลัมน์และแถว ซึ่งช่วยให้ฟังก์ชัน เลือกหลายรายการต่อแถวจากลำดับช่องทำเครื่องหมาย |
addCheckboxItem() | CheckboxItem | เพิ่มรายการคำถามใหม่เพื่อให้ผู้ตอบเลือกช่องทำเครื่องหมายได้อย่างน้อย 1 ช่อง รวมถึงตัวเลือก "อื่นๆ" ด้วย |
addDateItem() | DateItem | เพิ่มรายการคำถามใหม่ที่ช่วยให้ผู้ตอบระบุวันที่ได้ |
addDateTimeItem() | DateTimeItem | เพิ่มรายการคำถามใหม่เพื่อให้ผู้ตอบระบุวันที่และเวลาได้ |
addDurationItem() | DurationItem | เพิ่มรายการคำถามใหม่ต่อท้ายเพื่อให้ผู้ตอบสามารถระบุระยะเวลาได้ |
addEditor(emailAddress) | Form | เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ Form |
addEditor(user) | Form | เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ Form |
addEditors(emailAddresses) | Form | เพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการเครื่องมือแก้ไขสำหรับ Form |
addGridItem() | GridItem | เพิ่มรายการคำถามใหม่ ซึ่งแสดงเป็นตารางกริดที่มีคอลัมน์และแถว ซึ่งช่วยให้ฟังก์ชัน เลือก 1 ตัวเลือกต่อแถวจากปุ่มตัวเลือกตามลำดับ |
addImageItem() | ImageItem | เพิ่มรายการเลย์เอาต์ใหม่ที่แสดงรูปภาพ |
addListItem() | ListItem | เพิ่มรายการคำถามใหม่ที่ช่วยให้ผู้ตอบเลือก 1 ตัวเลือกจากเมนูแบบเลื่อนลงได้ รายการ |
addMultipleChoiceItem() | MultipleChoiceItem | เพิ่มรายการคำถามใหม่ที่ช่วยให้ผู้ตอบเลือก 1 ตัวเลือกจากรายการวิทยุ ปุ่มหรือเลือก "อื่นๆ" ด้วย |
addPageBreakItem() | PageBreakItem | เพิ่มรายการเลย์เอาต์ใหม่ที่ทำเครื่องหมายจุดเริ่มต้นของหน้า |
addParagraphTextItem() | ParagraphTextItem | เพิ่มรายการคำถามใหม่ที่อนุญาตให้ผู้ตอบป้อนบล็อกข้อความ |
addScaleItem() | ScaleItem | ต่อท้ายรายการคำถามใหม่ที่ให้ผู้ตอบเลือก 1 ตัวเลือกจากหมายเลข ลำดับของปุ่มตัวเลือก |
addSectionHeaderItem() | SectionHeaderItem | ต่อท้ายรายการเลย์เอาต์ใหม่ที่แสดงให้เห็นจุดเริ่มต้นของส่วน |
addTextItem() | TextItem | เพิ่มรายการคำถามใหม่ที่ช่วยให้ผู้ตอบป้อนข้อความ 1 บรรทัดได้ |
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 | ระบุว่าแบบฟอร์มอนุญาตให้มีเพียง 1 คำตอบต่อผู้ตอบ 1 คนหรือไม่ |
hasProgressBar() | Boolean | กำหนดว่าแบบฟอร์มจะแสดงแถบความคืบหน้าหรือไม่ |
hasRespondAgainLink() | Boolean | กำหนดว่าแบบฟอร์มจะแสดงลิงก์เพื่อส่งคำตอบอีกหลังจากผู้ตอบหรือไม่ กรอกแบบฟอร์ม |
isAcceptingResponses() | Boolean | กำหนดว่าแบบฟอร์มยอมรับการตอบกลับอยู่หรือไม่ |
isPublishingSummary() | Boolean | กำหนดว่าแบบฟอร์มจะแสดงลิงก์เพื่อดูข้อมูลสรุปของคำตอบหลังจากผู้ตอบหรือไม่ กรอกแบบฟอร์ม |
isQuiz() | Boolean | ระบุว่าแบบฟอร์มเป็นแบบทดสอบหรือไม่ |
moveItem(from, to) | Item | ย้ายรายการในดัชนีที่กำหนดจากรายการทั้งหมดในแบบฟอร์มไปยังดัชนีที่กำหนดอีกรายการ |
moveItem(item, toIndex) | Item | ย้ายรายการที่กำหนดไปยังดัชนีที่กำหนดจากรายการทั้งหมดในแบบฟอร์ม |
removeDestination() | Form | ยกเลิกการลิงก์แบบฟอร์มจากปลายทางการตอบกลับปัจจุบัน |
removeEditor(emailAddress) | Form | นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Form |
removeEditor(user) | Form | นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Form |
requiresLogin() | Boolean | กำหนดว่าแบบฟอร์มกำหนดให้ผู้ตอบต้องเข้าสู่ระบบบัญชีในโดเมนเดียวกันหรือไม่ โดเมนย่อยก่อนที่จะตอบสนอง |
setAcceptingResponses(enabled) | Form | ตั้งค่าว่าแบบฟอร์มยอมรับการตอบกลับหรือไม่ |
setAllowResponseEdits(enabled) | Form | กำหนดว่าแบบฟอร์มจะแสดงลิงก์เพื่อแก้ไขคำตอบหลังจากส่งแล้วหรือไม่ |
setCollectEmail(collect) | Form | ตั้งค่าว่าแบบฟอร์มจะรวบรวมผู้ตอบหรือไม่ อีเมล |
setConfirmationMessage(message) | Form | ตั้งค่าข้อความยืนยันของแบบฟอร์ม |
setCustomClosedFormMessage(message) | Form | ตั้งค่าข้อความที่จะแสดงหากแบบฟอร์มไม่ยอมรับการตอบกลับ |
setDescription(description) | Form | ตั้งค่าคำอธิบายของแบบฟอร์ม |
setDestination(type, id) | Form | ตั้งค่าปลายทางที่จะบันทึกคำตอบของแบบฟอร์ม |
setIsQuiz(enabled) | Form | กำหนดว่าแบบฟอร์มจะเป็นแบบทดสอบหรือไม่ |
setLimitOneResponsePerUser(enabled) | Form | ตั้งค่าว่าแบบฟอร์มจะอนุญาตเพียง 1 คำตอบต่อผู้ตอบ 1 คนหรือไม่ |
setProgressBar(enabled) | Form | ตั้งค่าว่าแบบฟอร์มมีแถบความคืบหน้าหรือไม่ |
setPublishingSummary(enabled) | Form | ตั้งค่าว่าจะให้แบบฟอร์มแสดงลิงก์เพื่อดูข้อมูลสรุปของคำตอบหรือไม่หลังจากที่ผู้ตอบส่ง แบบฟอร์ม |
setRequireLogin(requireLogin) | Form | ตั้งค่าว่าแบบฟอร์มจะกำหนดให้ผู้ตอบเข้าสู่ระบบบัญชีในโดเมนเดียวกันหรือ โดเมนย่อยก่อนที่จะตอบกลับ |
setShowLinkToRespondAgain(enabled) | Form | กำหนดว่าแบบฟอร์มจะแสดงลิงก์สำหรับส่งคำตอบอื่นหลังจากที่ผู้ตอบตอบเสร็จแล้วหรือไม่ แบบฟอร์ม |
setShuffleQuestions(shuffle) | Form | กำหนดว่าลำดับของคำถามในแต่ละหน้าของแบบฟอร์มจะเป็นแบบสุ่มหรือไม่ |
setTitle(title) | Form | ตั้งชื่อแบบฟอร์ม |
shortenFormUrl(url) | String | แปลง URL แบบยาวสำหรับแบบฟอร์มเป็น URL แบบสั้น |
submitGrades(responses) | Form | ส่งคะแนนสำหรับ FormResponses ที่ระบุ |
เอกสารโดยละเอียด
addCheckboxGridItem()
เพิ่มรายการคำถามใหม่ ซึ่งแสดงเป็นตารางกริดที่มีคอลัมน์และแถว ซึ่งช่วยให้ฟังก์ชัน เลือกหลายรายการต่อแถวจากลำดับช่องทำเครื่องหมาย
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Adds a checkbox grid item. const item = form.addCheckboxGridItem(); // Sets the title 'Where did you celebrate New Year's?' item.setTitle('Where did you celebrate New Year's?'); // Sets the grid's rows and columns. item.setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
รีเทิร์น
CheckboxGridItem
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addCheckboxItem()
เพิ่มรายการคำถามใหม่เพื่อให้ผู้ตอบเลือกช่องทำเครื่องหมายได้อย่างน้อย 1 ช่อง รวมถึงตัวเลือก "อื่นๆ" ด้วย
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(emailAddress)
เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ Form
หากผู้ใช้เคยเป็นสมาชิกแล้ว
ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
emailAddress | String | อีเมลของผู้ใช้ที่ต้องการเพิ่ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditor(user)
เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ Form
หากผู้ใช้เคยเป็นสมาชิกแล้ว
ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
user | User | การนำเสนอของผู้ใช้ที่จะเพิ่ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addEditors(emailAddresses)
เพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการเครื่องมือแก้ไขสำหรับ Form
หากมี
มีผู้ใช้อยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะช่วยโปรโมตพวกเขาออกจากรายการ
ผู้ดู
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
emailAddresses | String[] | อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addGridItem()
เพิ่มรายการคำถามใหม่ซึ่งแสดงเป็นตารางกริดที่มีคอลัมน์และแถว ซึ่งช่วยให้ฟังก์ชัน เลือก 1 ตัวเลือกต่อแถวจากปุ่มตัวเลือกตามลำดับ
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addListItem()
ต่อท้ายรายการคำถามใหม่เพื่อให้ผู้ตอบเลือก 1 ตัวเลือกจากเมนูแบบเลื่อนลง รายการ
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addMultipleChoiceItem()
เพิ่มรายการคำถามใหม่ที่ช่วยให้ผู้ตอบเลือก 1 ตัวเลือกจากรายการวิทยุ ปุ่มหรือเลือก "อื่นๆ" ด้วย
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addScaleItem()
ต่อท้ายรายการคำถามใหม่ที่ช่วยให้ผู้ตอบเลือก 1 ตัวเลือกจากหมายเลข ลำดับของปุ่มตัวเลือก
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
addTextItem()
เพิ่มรายการคำถามใหม่ต่อท้ายที่อนุญาตให้ผู้ตอบป้อนข้อความ 1 บรรทัด
// 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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รายการที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากทำได้
ใช้ไม่ได้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากไม่เป็นเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse()
สร้างคำตอบใหม่สำหรับแบบฟอร์ม หากต้องการตอบรายการคำถาม ให้สร้าง ItemResponse
จากรายการ แล้วแนบมากับคำตอบของแบบฟอร์มนี้โดยการเรียกใช้ FormResponse.withItemResponse(response)
หากต้องการบันทึกการตอบกลับที่รวบรวมไว้ ให้เรียกใช้ FormResponse.submit()
รีเทิร์น
FormResponse
— คำตอบของแบบฟอร์มที่สร้างใหม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteAllResponses()
ลบคำตอบที่ส่งทั้งหมดจากที่เก็บคำตอบของแบบฟอร์ม วิธีการนี้ไม่ได้ลบ สำเนาของคำตอบที่จัดเก็บไว้ในปลายทางการตอบกลับภายนอก (เช่น สเปรดชีต) แต่กลับ ล้างมุมมองสรุปของแบบฟอร์ม
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— หากไม่มีรายการอยู่ในดัชนีที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— หากไม่มีรายการนั้นในแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
deleteResponse(responseId)
ลบคำตอบเดียวจากที่เก็บคำตอบของแบบฟอร์ม วิธีนี้จะไม่ลบสำเนาของ
การตอบกลับที่จัดเก็บไว้ในปลายทางการตอบกลับภายนอก (เช่น สเปรดชีต) แต่จะนำ
คำตอบจากมุมมองสรุปของแบบฟอร์ม ดูรหัสการตอบกลับได้ด้วย FormResponse.getId()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
responseId | String | รหัสของคำตอบในแบบฟอร์มที่จะลบ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— ข้อความยืนยันของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— ข้อความที่กำหนดเองที่จะแสดงหากแบบฟอร์มไม่รับคำตอบหรือว่างเปล่า
สตริง ถ้าไม่ได้ตั้งค่าข้อความที่กำหนดเองไว้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— คำอธิบายของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— รหัสปลายทางการตอบกลับของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— ประเภทของปลายทางการตอบกลับของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 ที่จะแก้ไขแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getEditors()
getId()
รับรหัสของแบบฟอร์ม
// Opens the form by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Gets the ID of the form and logs it to the console. const id = form.getId(); console.log(id);
รีเทิร์น
String
— รหัสของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากไม่มีรายการดังกล่าวในแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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[]
— อาร์เรย์ของรายการทั้งหมดในแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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[]
— อาร์เรย์ของรายการทั้งหมดประเภทนั้น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 ที่จะตอบกลับแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponse(responseId)
รับการตอบกลับแบบฟอร์มเดียวตามรหัสการตอบกลับ คุณดึงรหัสการตอบกลับได้จาก FormResponse.getId()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
responseId | String | รหัสสำหรับคำตอบของแบบฟอร์ม |
รีเทิร์น
FormResponse
— คำตอบของแบบฟอร์ม
การขว้าง
Error
— หากไม่มีการตอบกลับ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses()
รับอาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์ม
รีเทิร์น
FormResponse[]
— อาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getResponses(timestamp)
รับอาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์มหลังจากวันที่และเวลาที่ระบุ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
timestamp | Date | วันที่และเวลาแรกสุดที่ควรแสดงผลคำตอบของแบบฟอร์ม |
รีเทิร์น
FormResponse[]
— รายการคำตอบในแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getShuffleQuestions()
กำหนดว่าลำดับของคำถามในแต่ละหน้าของแบบฟอร์มเป็นแบบสุ่มหรือไม่
รีเทิร์น
Boolean
— true
หากลำดับของคำถามในแต่ละหน้าของแบบฟอร์มเป็นแบบสุ่ม
false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 สำหรับดูข้อมูลสรุปของคำตอบ
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— ชื่อแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
hasLimitOneResponsePerUser()
ระบุว่าแบบฟอร์มอนุญาตให้มีเพียง 1 คำตอบต่อผู้ตอบ 1 คนหรือไม่ หากค่าเป็น true
สคริปต์จะส่งคำตอบของแบบฟอร์มไม่ได้
รีเทิร์น
Boolean
— true
ถ้าแบบฟอร์มอนุญาตให้ตอบได้เพียง 1 คำตอบต่อผู้ตอบ 1 คน false
หากไม่
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากไม่เป็นเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากทำได้
ใช้ไม่ได้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากไม่เป็นเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากทำได้
ใช้ไม่ได้
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
หากไม่เป็นเช่นนั้น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
moveItem(from, to)
ย้ายรายการในดัชนีที่กำหนดจากรายการทั้งหมดในแบบฟอร์มไปยังดัชนีที่กำหนดอีกรายการ การขว้าง
ข้อยกเว้นการเขียนสคริปต์หากดัชนี to
อยู่นอกขอบเขต
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Moves the first item to be the last item. form.moveItem(0, form.getItems().length - 1);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
from | Integer | ดัชนีปัจจุบันของสินค้าจากทุกรายการในแบบฟอร์ม |
to | Integer | ดัชนีใหม่ของสินค้าจากรายการทั้งหมดในแบบฟอร์ม |
รีเทิร์น
Item
— รายการที่ย้าย
การขว้าง
Error
— หากดัชนีใดดัชนีหนึ่งอยู่นอกขอบเขต
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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
— หากดัชนีอยู่นอกขอบเขต
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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();
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(emailAddress)
นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Form
วิธีนี้ไม่
บล็อกไม่ให้ผู้ใช้เข้าถึง Form
หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่มี
สิทธิ์การเข้าถึงทั่วไป เช่น หากแชร์ Form
กับทั้งหมดของผู้ใช้
หรือหาก Form
อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้
สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
emailAddress | String | อีเมลของผู้ใช้ที่จะนำออก |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
removeEditor(user)
นำผู้ใช้ที่ระบุออกจากรายชื่อเอดิเตอร์ของ Form
วิธีนี้ไม่
บล็อกไม่ให้ผู้ใช้เข้าถึง Form
หากผู้ใช้อยู่ในกลุ่มผู้ใช้ที่มี
สิทธิ์การเข้าถึงทั่วไป เช่น หากแชร์ Form
กับทั้งหมดของผู้ใช้
หรือหาก Form
อยู่ในไดรฟ์ที่แชร์ที่ผู้ใช้เข้าถึงได้
สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
user | User | การนำเสนอของผู้ใช้ที่จะนำออก |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
requiresLogin()
กำหนดว่าแบบฟอร์มกำหนดให้ผู้ตอบต้องเข้าสู่ระบบบัญชีในโดเมนเดียวกันหรือไม่ โดเมนย่อยก่อนที่จะตอบสนอง
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Checks if the form requires respondents to log in to a Google Workspace account // before responding and logs it to the console. const login = form.requiresLogin(); console.log(login);
รีเทิร์น
Boolean
— true
หากแบบฟอร์มกำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ false
หากไม่เป็นเช่นนั้น
setAcceptingResponses(enabled)
ตั้งค่าว่าแบบฟอร์มยอมรับการตอบกลับหรือไม่ ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ true
// Opens the Forms file by its URL. If you created your script from within a // Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form to accept responses. form.setAcceptingResponses(true); // Checks whether the form is accepting responses or not and logs it to the console. console.log(form.isAcceptingResponses());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากแบบฟอร์มควรยอมรับการตอบกลับ false หากไม่ต้องการให้เป็นเช่นนั้น |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 หากไม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 หากทำได้
ใช้ไม่ได้ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 | ข้อความยืนยันใหม่ของแบบฟอร์ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 | ข้อความที่จะแสดงเมื่อแบบฟอร์มไม่ยอมรับการตอบกลับ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDescription(description)
ตั้งค่าคำอธิบายของแบบฟอร์ม
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
description | String | คำอธิบายใหม่ของแบบฟอร์ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setDestination(type, id)
ตั้งค่าปลายทางที่จะบันทึกคำตอบของแบบฟอร์ม แบบฟอร์มทั้งหมด รวมถึงแบบฟอร์มที่ไม่มี กำหนดปลายทางไว้อย่างชัดเจน ให้บันทึกสำเนาของคำตอบไว้ใน ที่จัดเก็บคำตอบ
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
type | DestinationType | ประเภทปลายทางการตอบกลับของแบบฟอร์ม |
id | String | รหัสปลายทางการตอบกลับของแบบฟอร์ม |
รีเทิร์น
การขว้าง
Error
— หากรหัสปลายทางที่ระบุไม่ถูกต้อง
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setIsQuiz(enabled)
กำหนดว่าแบบฟอร์มจะเป็นแบบทดสอบหรือไม่ ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ false
มีคำถามที่ให้คะแนนแล้วในแบบทดสอบเท่านั้น ดังนั้นการตั้งค่านี้เป็น false
จะทำให้
ตัวเลือกการให้คะแนนจะถูกนำออกจากคำถามทั้งหมด
การตั้งค่าแบบทดสอบใช้ได้เฉพาะใน UI ใหม่ของฟอร์มเท่านั้น การสร้างแบบฟอร์มเป็นแบบทดสอบคือการเลือกแบบฟอร์ม ไปใช้ UI แบบใหม่กัน
// 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 หาก
ไม่ได้ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setLimitOneResponsePerUser(enabled)
ตั้งค่าว่าแบบฟอร์มจะอนุญาตเพียง 1 คำตอบต่อผู้ตอบ 1 คนหรือไม่ ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ
false
หากตั้งค่าเป็น true
สคริปต์จะส่งคำตอบของแบบฟอร์มที่
ทั้งหมด
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากแบบฟอร์มควรอนุญาตเพียง 1 คำตอบต่อผู้ตอบ 1 คน false หากไม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
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 หากไม่เป็นเช่นนั้น |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setPublishingSummary(enabled)
ตั้งค่าว่าจะให้แบบฟอร์มแสดงลิงก์เพื่อดูข้อมูลสรุปของคำตอบหรือไม่หลังจากที่ผู้ตอบส่ง
แบบฟอร์ม ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ false
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากแบบฟอร์มควรแสดง "ดูคำตอบก่อนหน้า" ลิงก์; false หากไม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequireLogin(requireLogin)
ตั้งค่าว่าแบบฟอร์มจะกำหนดให้ผู้ตอบเข้าสู่ระบบบัญชีในโดเมนเดียวกันหรือ
โดเมนย่อยก่อนที่จะตอบกลับ ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ false
เว้นแต่จะเป็นโดเมน
ผู้ดูแลระบบเปลี่ยนค่าเริ่มต้น
ฟีเจอร์นี้ใช้ได้กับแบบฟอร์มที่สร้างโดยผู้ใช้ Google Workspace เท่านั้น ผู้ใช้ของผู้อื่น ประเภทของบัญชี Google ที่ไม่จำเป็นเพื่อเข้าสู่ระบบ
// Opens the Forms file by its URL. If you created your script from within // a Google Forms file, you can use FormApp.getActiveForm() instead. // TODO(developer): Replace the URL with your own. const form = FormApp.openByUrl('https://docs.google.com/forms/d/abc123456/edit'); // Sets the form so that users must log in to their Google Workspace account. form.setRequireLogin(true); // Checks whether the form requires login or not and logs it to the console. console.log(form.requiresLogin());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
requireLogin | Boolean | true หากแบบฟอร์มกำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ false หากทำได้
ใช้ไม่ได้ |
รีเทิร์น
Form
— แบบฟอร์มปัจจุบัน (สำหรับการทำสายโซ่)
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShowLinkToRespondAgain(enabled)
กำหนดว่าแบบฟอร์มจะแสดงลิงก์สำหรับส่งคำตอบอื่นหลังจากที่ผู้ตอบตอบเสร็จแล้วหรือไม่
แบบฟอร์ม ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ true
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
enabled | Boolean | true หากแบบฟอร์มควรแสดง "ส่งคำตอบอื่น" ลิงก์; false หากไม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setShuffleQuestions(shuffle)
กำหนดว่าลำดับของคำถามในแต่ละหน้าของแบบฟอร์มจะเป็นแบบสุ่มหรือไม่
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
shuffle | Boolean | true หากลำดับคำถามในแต่ละหน้าของแบบฟอร์มควรเป็น
สุ่ม; false หากไม่ |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
shortenFormUrl(url)
แปลง URL แบบยาวสำหรับแบบฟอร์มเป็น URL แบบสั้น มีข้อยกเว้นหาก URL แบบยาวไม่เป็นไปตาม เป็นของ Google ฟอร์ม
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
url | String | URL ที่จะย่อ |
รีเทิร์น
String
— URL ในรูปแบบ http://goo.gl/forms/1234
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
submitGrades(responses)
ส่งคะแนนสำหรับ FormResponses ที่ระบุ
หากโค้ดของคุณมีทริกเกอร์ onFormSubmit
การเรียกใช้ submitGrades()
ทริกเกอร์เงื่อนไข onFormSubmit
และทําให้เกิดการวนซ้ำอย่างไม่สิ้นสุด เพื่อป้องกันไม่ให้การเรียก
วนซ้ำไปเรื่อยๆ เพิ่มโค้ดที่ตรวจสอบว่ามีคะแนนอยู่แล้วหรือไม่ก่อนเรียก submitGrades()
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
responses | FormResponse[] | อาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์ม |
รีเทิร์น
การให้สิทธิ์
สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms