หน้านี้ได้รับการแปลโดย Cloud Translation API

Class FormApp

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

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

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

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

พร็อพเพอร์ตี้	ประเภท	คำอธิบาย
`Alignment`	`Alignment`	การแจกแจงประเภทการจัดแนวรูปภาพ
`DestinationType`	`DestinationType`	การแจกแจงประเภทของปลายทางที่จัดเก็บคําตอบของแบบฟอร์มได้
`FeedbackType`	`FeedbackType`	การแจกแจงประเภทของแบบฟอร์ม `Feedbacks`
`ItemType`	`ItemType`	การแจกแจงประเภทของแบบฟอร์ม `Items`
`PageNavigationType`	`PageNavigationType`	การแจกแจงลักษณะการทำงานที่เป็นไปได้สําหรับการไปยังส่วนต่างๆ ของหน้า
`RatingIconType`	`RatingIconType`	การแจกแจงประเภทไอคอนการให้คะแนน `RatingIcons`

เมธอด

วิธีการ	ประเภทการแสดงผล	รายละเอียดแบบย่อ
`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.
const form = FormApp.create('Form Name');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`title`	`String`	ชื่อของแบบฟอร์มใหม่

รีเทิร์น

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.
const form = FormApp.getActiveForm();

รีเทิร์น

Form — ฟอร์มที่สคริปต์เชื่อมโยงอยู่ หรือ null หากสคริปต์ไม่ได้เชื่อมโยงกับฟอร์ม

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

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`id`	`String`	รหัสของแบบฟอร์มที่จะเปิด

รีเทิร์น

Form — แบบฟอร์มที่มีรหัสที่ระบุ

โยน

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

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

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

`openByUrl(url)`

แสดง Form ที่มี URL ที่ระบุ แสดงข้อยกเว้นหาก URL ไม่ถูกต้องหรือผู้ใช้ไม่มีสิทธิ์เปิดแบบฟอร์ม

// Open a form by URL.
const form = FormApp.openByUrl(
    'https://docs.google.com/forms/d/1234567890abcdefghijklmnopqrstuvwxyz_a1b2c3/edit',
);

พารามิเตอร์

ชื่อ	ประเภท	คำอธิบาย
`url`	`String`	URL ของแบบฟอร์มที่จะเปิด

รีเทิร์น

Form — แบบฟอร์มที่มี URL ที่ระบุ

โยน

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

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

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