Class FormApp

FormApp

อนุญาตให้สคริปต์เปิด Form ที่มีอยู่หรือสร้างสคริปต์ใหม่

// Open a form by ID.
var existingForm = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

// Create and open a form.
var newForm = FormApp.create('Form Name');

พร็อพเพอร์ตี้

พร็อพเพอร์ตี้Typeคำอธิบาย
AlignmentAlignmentการแจกแจงประเภทของการปรับแนวรูปภาพ
DestinationTypeDestinationTypeการแจงนับประเภทปลายทางที่จัดเก็บคำตอบของแบบฟอร์มได้
FeedbackTypeFeedbackTypeการแจกแจงประเภทของแบบฟอร์ม Feedbacks
ItemTypeItemTypeการแจกแจงประเภทของแบบฟอร์ม Items
PageNavigationTypePageNavigationTypeการแจกแจงพฤติกรรมที่เป็นไปได้สำหรับการนำทางหน้าเว็บ

วิธีการ

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
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คำอธิบาย
titleStringชื่อแบบฟอร์มใหม่

รีเทิร์น

Form — แบบฟอร์มใหม่

การขว้าง

Error — หากชื่อที่ระบุเป็น null หรือว่างเปล่า

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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

createCheckboxGridValidation()

แสดงผลอินสแตนซ์ของ CheckboxGridValidationBuilder ซึ่งใช้เพื่อตั้งค่าการตรวจสอบใน CheckboxGridItem ได้

รีเทิร์น

CheckboxGridValidationBuilder


createCheckboxValidation()

แสดงผลอินสแตนซ์ของ CheckboxValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน CheckboxItem ได้

รีเทิร์น

CheckboxValidationBuilder


createFeedback()

แสดงผลอินสแตนซ์ของ QuizfeedbackBuilder ซึ่งใช้ตั้งค่าความคิดเห็นเกี่ยวกับ Item ที่ให้คะแนนได้

รีเทิร์น

QuizFeedbackBuilder


createGridValidation()

แสดงผลอินสแตนซ์ของ GridValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน GridItem ได้

รีเทิร์น

GridValidationBuilder


createParagraphTextValidation()

แสดงผลอินสแตนซ์ของ ParagraphTextValidationBuilder ซึ่งใช้ตั้งค่าการตรวจสอบใน ParagraphTextItem ได้

รีเทิร์น

ParagraphTextValidationBuilder


createTextValidation()

แสดงผลอินสแตนซ์ของ TextValidationBuilder ที่สามารถใช้เพื่อตั้งค่าการตรวจสอบใน TextItem

รีเทิร์น

TextValidationBuilder


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คำอธิบาย
idStringรหัสของแบบฟอร์มที่จะเปิด

รีเทิร์น

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คำอธิบาย
urlStringURL ของแบบฟอร์มที่จะเปิด

รีเทิร์น

Form — แบบฟอร์มที่มี URL ที่ให้มา

การขว้าง

Error — หาก URL ที่ระบุไม่ถูกต้องหรือผู้ใช้มีสิทธิ์ไม่เพียงพอ

การให้สิทธิ์

สคริปต์ที่ใช้วิธีการนี้ต้องได้รับสิทธิ์จากขอบเขตต่อไปนี้อย่างน้อย 1 รายการ

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