อนุญาตให้สคริปต์เปิด Form
ที่มีอยู่หรือสร้างสคริปต์ใหม่
// Open a form by ID. var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); // Create and open a form. var newForm = FormApp.create('Form Name');
พร็อพเพอร์ตี้
พร็อพเพอร์ตี้ | Type | คำอธิบาย |
---|---|---|
Alignment | Alignment | การแจกแจงประเภทของการปรับแนวรูปภาพ |
DestinationType | DestinationType | การแจงนับประเภทปลายทางที่จัดเก็บคำตอบของแบบฟอร์มได้ |
FeedbackType | FeedbackType | การแจกแจงประเภทของแบบฟอร์ม Feedbacks |
ItemType | ItemType | การแจกแจงประเภทของแบบฟอร์ม Items |
PageNavigationType | PageNavigationType | การแจกแจงพฤติกรรมที่เป็นไปได้สำหรับการนำทางหน้าเว็บ |
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
create(title) | Form | สร้างและแสดงผล Form ใหม่ |
createCheckboxGridValidation() | CheckboxGridValidationBuilder | แสดงผลอินสแตนซ์ของ CheckboxGridValidationBuilder ซึ่งใช้เพื่อตั้งค่าการตรวจสอบใน CheckboxGridItem ได้ |
createCheckboxValidation() | CheckboxValidationBuilder | แสดงผลอินสแตนซ์ของ CheckboxValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน CheckboxItem ได้ |
createFeedback() | QuizFeedbackBuilder | แสดงผลอินสแตนซ์ของ QuizfeedbackBuilder ซึ่งใช้ตั้งค่าความคิดเห็นเกี่ยวกับ Item ที่ให้คะแนนได้ |
createGridValidation() | GridValidationBuilder | แสดงผลอินสแตนซ์ของ GridValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน GridItem ได้ |
createParagraphTextValidation() | ParagraphTextValidationBuilder | แสดงผลอินสแตนซ์ของ ParagraphTextValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน ParagraphTextItem ได้ |
createTextValidation() | TextValidationBuilder | แสดงผลอินสแตนซ์ของ TextValidationBuilder ที่สามารถใช้เพื่อตั้งค่าการตรวจสอบใน TextItem |
getActiveForm() | Form | แสดงผลแบบฟอร์มที่สคริปต์เชื่อมโยงกับคอนเทนเนอร์ |
getUi() | Ui | แสดงผลอินสแตนซ์ของสภาพแวดล้อมอินเทอร์เฟซผู้ใช้ของเครื่องมือแก้ไขแบบฟอร์มที่อนุญาตให้สคริปต์เพิ่มฟีเจอร์ต่างๆ เช่น เมนู กล่องโต้ตอบ และแถบด้านข้าง |
openById(id) | Form | แสดงผล Form ที่มีรหัสที่ระบุ |
openByUrl(url) | Form | แสดงผล Form ที่มี URL ที่ระบุ |
เอกสารประกอบโดยละเอียด
create(title)
สร้างและแสดงผล Form
ใหม่ ระบบแสดงข้อยกเว้นหากชื่อที่ระบุเป็น null
หรือว่างเปล่า
// Create and open a form. var form = FormApp.create('Form Name');
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
title | String | ชื่อแบบฟอร์มใหม่ |
รีเทิร์น
Form
— แบบฟอร์มใหม่
การขว้าง
Error
— หากชื่อที่ระบุเป็น null
หรือว่างเปล่า
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms
createCheckboxGridValidation()
แสดงผลอินสแตนซ์ของ CheckboxGridValidationBuilder ซึ่งใช้เพื่อตั้งค่าการตรวจสอบใน CheckboxGridItem
ได้
รีเทิร์น
createCheckboxValidation()
แสดงผลอินสแตนซ์ของ CheckboxValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน CheckboxItem
ได้
รีเทิร์น
createFeedback()
แสดงผลอินสแตนซ์ของ QuizfeedbackBuilder ซึ่งใช้ตั้งค่าความคิดเห็นเกี่ยวกับ Item
ที่ให้คะแนนได้
รีเทิร์น
createGridValidation()
แสดงผลอินสแตนซ์ของ GridValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน GridItem
ได้
รีเทิร์น
createParagraphTextValidation()
แสดงผลอินสแตนซ์ของ ParagraphTextValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน ParagraphTextItem
ได้
รีเทิร์น
createTextValidation()
แสดงผลอินสแตนซ์ของ TextValidationBuilder ที่สามารถใช้เพื่อตั้งค่าการตรวจสอบใน TextItem
รีเทิร์น
getActiveForm()
แสดงผลแบบฟอร์มที่สคริปต์เชื่อมโยงกับคอนเทนเนอร์ หากต้องการโต้ตอบกับแบบฟอร์มที่ไม่ได้ผูกกับคอนเทนเนอร์ ให้ใช้ openById(id)
หรือ openByUrl(url)
แทน
// Get the form to which this script is bound. var form = FormApp.getActiveForm();
รีเทิร์น
Form
— แบบฟอร์มที่สคริปต์เชื่อมโยง หรือ null
ในกรณีที่สคริปต์ไม่ได้ผูกกับแบบฟอร์ม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getUi()
แสดงผลอินสแตนซ์ของสภาพแวดล้อมอินเทอร์เฟซผู้ใช้ของเครื่องมือแก้ไขแบบฟอร์มที่อนุญาตให้สคริปต์เพิ่มฟีเจอร์ต่างๆ เช่น เมนู กล่องโต้ตอบ และแถบด้านข้าง สคริปต์จะโต้ตอบกับ UI ได้เฉพาะอินสแตนซ์ปัจจุบันของเครื่องมือแก้ไขแบบฟอร์มแบบเปิด (ไม่ใช่มุมมองที่ผู้ตอบเห็น) และเฉพาะในกรณีที่สคริปต์เชื่อมโยงกับแบบฟอร์ม ดูข้อมูลเพิ่มเติมได้ในคู่มือสำหรับเมนู รวมถึงกล่องโต้ตอบและแถบด้านข้าง
// Add a custom menu to the active form, including a separator and a sub-menu. function onOpen(e) { FormApp.getUi() .createMenu('My Menu') .addItem('My menu item', 'myFunction') .addSeparator() .addSubMenu(FormApp.getUi().createMenu('My sub-menu') .addItem('One sub-menu item', 'mySecondFunction') .addItem('Another sub-menu item', 'myThirdFunction')) .addToUi(); }
รีเทิร์น
Ui
— อินสแตนซ์ของสภาพแวดล้อมอินเทอร์เฟซผู้ใช้ของแบบฟอร์มนี้
openById(id)
แสดงผล Form
ที่มีรหัสที่ระบุ ระบบจะแสดงข้อผิดพลาดหากรหัสไม่ถูกต้อง หรือผู้ใช้ไม่มีสิทธิ์เปิดแบบฟอร์ม
// Open a form by ID. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
id | String | รหัสของแบบฟอร์มที่จะเปิด |
รีเทิร์น
Form
— แบบฟอร์มที่มีรหัสที่ระบุ
การขว้าง
Error
— หากรหัสที่ระบุไม่ถูกต้องหรือผู้ใช้มีสิทธิ์ไม่เพียงพอ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms
openByUrl(url)
แสดงผล Form
ที่มี URL ที่ระบุ ระบบแสดงข้อยกเว้นหาก URL ไม่ถูกต้องหรือผู้ใช้ไม่มีสิทธิ์เปิดแบบฟอร์ม
// Open a form by URL. var form = FormApp.openByUrl( 'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit' );
พารามิเตอร์
ชื่อ | Type | คำอธิบาย |
---|---|---|
url | String | URL ของแบบฟอร์มที่จะเปิด |
รีเทิร์น
Form
— แบบฟอร์มที่มี URL ที่ให้มา
การขว้าง
Error
— หาก URL ที่ระบุไม่ถูกต้องหรือผู้ใช้มีสิทธิ์ไม่เพียงพอ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/forms