Class Form

แบบฟอร์ม

แบบฟอร์มที่มีพร็อพเพอร์ตี้และรายการโดยรวม พร็อพเพอร์ตี้มีชื่อ การตั้งค่า และตำแหน่ง และจัดเก็บคำตอบไว้ รายการประกอบด้วยรายการคำถาม เช่น ช่องทำเครื่องหมายหรือรายการตัวเลือก ขณะที่เลย์เอาต์ รายการหมายถึงสิ่งต่างๆ เช่น ตัวแบ่งหน้า คุณสามารถเข้าถึงหรือสร้างแบบฟอร์มได้จาก 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 หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่ต้องการเพิ่ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

addEditor(user)

เพิ่มผู้ใช้ที่กำหนดไปยังรายชื่อเอดิเตอร์ของ Form หากผู้ใช้เคยเป็นสมาชิกแล้ว ในรายชื่อผู้ดู ซึ่งจะโปรโมตผู้ใช้ออกจากรายชื่อผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

addEditors(emailAddresses)

เพิ่มอาร์เรย์ของผู้ใช้ที่ระบุลงในรายการเครื่องมือแก้ไขสำหรับ Form หากมี มีผู้ใช้อยู่ในรายการผู้ดูอยู่แล้ว วิธีนี้จะช่วยโปรโมตพวกเขาออกจากรายการ ผู้ดู

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressesString[]อาร์เรย์อีเมลของผู้ใช้ที่จะเพิ่ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);

รีเทิร์น

Booleantrue หากแบบฟอร์มแสดงข้อความ "แก้ไขคำตอบของคุณ" ลิงก์; 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);

รีเทิร์น

Booleantrue หากแบบฟอร์มเก็บรวบรวมอีเมล 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()

ลบคำตอบที่ส่งทั้งหมดจากที่เก็บคำตอบของแบบฟอร์ม วิธีการนี้ไม่ได้ลบ สำเนาของคำตอบที่จัดเก็บไว้ในปลายทางการตอบกลับภายนอก (เช่น สเปรดชีต) แต่กลับ ล้างมุมมองสรุปของแบบฟอร์ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
indexIntegerดัชนีของรายการจากทุกรายการในแบบฟอร์ม

การขว้าง

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);
}

พารามิเตอร์

ชื่อประเภทคำอธิบาย
itemItemรายการที่จะลบ

การขว้าง

Error — หากไม่มีรายการนั้นในแบบฟอร์ม

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

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

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

deleteResponse(responseId)

ลบคำตอบเดียวจากที่เก็บคำตอบของแบบฟอร์ม วิธีนี้จะไม่ลบสำเนาของ การตอบกลับที่จัดเก็บไว้ในปลายทางการตอบกลับภายนอก (เช่น สเปรดชีต) แต่จะนำ คำตอบจากมุมมองสรุปของแบบฟอร์ม ดูรหัสการตอบกลับได้ด้วย FormResponse.getId()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
responseIdStringรหัสของคำตอบในแบบฟอร์มที่จะลบ

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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()

รับรายชื่อเอดิเตอร์ของ Form นี้

รีเทิร์น

User[] — อาร์เรย์ของผู้ใช้ที่มีสิทธิ์แก้ไข

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

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

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

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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
idIntegerรหัสของรายการ

รีเทิร์น

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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
itemTypeItemTypeประเภทของรายการที่จะดึงข้อมูล

รีเทิร์น

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()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
responseIdStringรหัสสำหรับคำตอบของแบบฟอร์ม

รีเทิร์น

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)

รับอาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์มหลังจากวันที่และเวลาที่ระบุ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
timestampDateวันที่และเวลาแรกสุดที่ควรแสดงผลคำตอบของแบบฟอร์ม

รีเทิร์น

FormResponse[] — รายการคำตอบในแบบฟอร์ม

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

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

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

getShuffleQuestions()

กำหนดว่าลำดับของคำถามในแต่ละหน้าของแบบฟอร์มเป็นแบบสุ่มหรือไม่

รีเทิร์น

Booleantrue หากลำดับของคำถามในแต่ละหน้าของแบบฟอร์มเป็นแบบสุ่ม 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 สคริปต์จะส่งคำตอบของแบบฟอร์มไม่ได้

รีเทิร์น

Booleantrue ถ้าแบบฟอร์มอนุญาตให้ตอบได้เพียง 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());

รีเทิร์น

Booleantrue หากแบบฟอร์มแสดงแถบความคืบหน้า false หากไม่เป็นเช่นนั้น

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

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

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

กำหนดว่าแบบฟอร์มจะแสดงลิงก์เพื่อส่งคำตอบอีกหลังจากผู้ตอบหรือไม่ กรอกแบบฟอร์ม

// 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());

รีเทิร์น

Booleantrue หากแบบฟอร์มแสดงข้อความ "ส่งคำตอบอื่น" ลิงก์; 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);

รีเทิร์น

Booleantrue หากแบบฟอร์มยอมรับการตอบกลับ 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);

รีเทิร์น

Booleantrue หากแบบฟอร์มแสดงข้อความ "ดูการตอบกลับก่อนหน้า" ลิงก์; 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());

รีเทิร์น

Booleantrue หากแบบฟอร์มยอมรับการตอบกลับ 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
fromIntegerดัชนีปัจจุบันของสินค้าจากทุกรายการในแบบฟอร์ม
toIntegerดัชนีใหม่ของสินค้าจากรายการทั้งหมดในแบบฟอร์ม

รีเทิร์น

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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
itemItemรายการที่จะย้าย
toIndexIntegerดัชนีใหม่ของสินค้าจากรายการทั้งหมดในแบบฟอร์ม

รีเทิร์น

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();

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

removeEditor(emailAddress)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
emailAddressStringอีเมลของผู้ใช้ที่จะนำออก

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

removeEditor(user)

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

สำหรับไฟล์ในไดรฟ์ การดำเนินการนี้จะนำผู้ใช้ออกจากรายการผู้ดูด้วย

พารามิเตอร์

ชื่อประเภทคำอธิบาย
userUserการนำเสนอของผู้ใช้ที่จะนำออก

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);

รีเทิร์น

Booleantrue หากแบบฟอร์มกำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มควรยอมรับการตอบกลับ false หากไม่ต้องการให้เป็นเช่นนั้น

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มควรแสดง "แก้ไขคำตอบของคุณ" ลิงก์; false หากไม่

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
collectBooleantrue หากแบบฟอร์มควรเก็บข้อมูลอีเมล false หากทำได้ ใช้ไม่ได้

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
messageStringข้อความยืนยันใหม่ของแบบฟอร์ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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);

พารามิเตอร์

ชื่อประเภทคำอธิบาย
messageStringข้อความที่จะแสดงเมื่อแบบฟอร์มไม่ยอมรับการตอบกลับ

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setDescription(description)

ตั้งค่าคำอธิบายของแบบฟอร์ม

พารามิเตอร์

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

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setDestination(type, id)

ตั้งค่าปลายทางที่จะบันทึกคำตอบของแบบฟอร์ม แบบฟอร์มทั้งหมด รวมถึงแบบฟอร์มที่ไม่มี กำหนดปลายทางไว้อย่างชัดเจน ให้บันทึกสำเนาของคำตอบไว้ใน ที่จัดเก็บคำตอบ

พารามิเตอร์

ชื่อประเภทคำอธิบาย
typeDestinationTypeประเภทปลายทางการตอบกลับของแบบฟอร์ม
idStringรหัสปลายทางการตอบกลับของแบบฟอร์ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

การขว้าง

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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากควรเปิดใช้ฟีเจอร์แบบทดสอบสำหรับแบบฟอร์ม false หาก ไม่ได้

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setLimitOneResponsePerUser(enabled)

ตั้งค่าว่าแบบฟอร์มจะอนุญาตเพียง 1 คำตอบต่อผู้ตอบ 1 คนหรือไม่ ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ false หากตั้งค่าเป็น true สคริปต์จะส่งคำตอบของแบบฟอร์มที่ ทั้งหมด

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มควรอนุญาตเพียง 1 คำตอบต่อผู้ตอบ 1 คน false หากไม่

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มแสดงแถบความคืบหน้า false หากไม่เป็นเช่นนั้น

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setPublishingSummary(enabled)

ตั้งค่าว่าจะให้แบบฟอร์มแสดงลิงก์เพื่อดูข้อมูลสรุปของคำตอบหรือไม่หลังจากที่ผู้ตอบส่ง แบบฟอร์ม ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ false

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มควรแสดง "ดูคำตอบก่อนหน้า" ลิงก์; false หากไม่

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

สคริปต์ที่ใช้เมธอดนี้ต้องมีการให้สิทธิ์กับขอบเขตต่อไปนี้อย่างน้อย 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());

พารามิเตอร์

ชื่อประเภทคำอธิบาย
requireLoginBooleantrue หากแบบฟอร์มกำหนดให้ผู้ใช้ต้องเข้าสู่ระบบ false หากทำได้ ใช้ไม่ได้

รีเทิร์น

Form — แบบฟอร์มปัจจุบัน (สำหรับการทำสายโซ่)

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

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

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

setShowLinkToRespondAgain(enabled)

กำหนดว่าแบบฟอร์มจะแสดงลิงก์สำหรับส่งคำตอบอื่นหลังจากที่ผู้ตอบตอบเสร็จแล้วหรือไม่ แบบฟอร์ม ค่าเริ่มต้นสำหรับแบบฟอร์มใหม่คือ true

พารามิเตอร์

ชื่อประเภทคำอธิบาย
enabledBooleantrue หากแบบฟอร์มควรแสดง "ส่งคำตอบอื่น" ลิงก์; false หากไม่

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setShuffleQuestions(shuffle)

กำหนดว่าลำดับของคำถามในแต่ละหน้าของแบบฟอร์มจะเป็นแบบสุ่มหรือไม่

พารามิเตอร์

ชื่อประเภทคำอธิบาย
shuffleBooleantrue หากลำดับคำถามในแต่ละหน้าของแบบฟอร์มควรเป็น สุ่ม; false หากไม่

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

setTitle(title)

ตั้งชื่อแบบฟอร์ม

พารามิเตอร์

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

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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

shortenFormUrl(url)

แปลง URL แบบยาวสำหรับแบบฟอร์มเป็น URL แบบสั้น มีข้อยกเว้นหาก URL แบบยาวไม่เป็นไปตาม เป็นของ Google ฟอร์ม

พารามิเตอร์

ชื่อประเภทคำอธิบาย
urlStringURL ที่จะย่อ

รีเทิร์น

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()

พารามิเตอร์

ชื่อประเภทคำอธิบาย
responsesFormResponse[]อาร์เรย์ของการตอบกลับทั้งหมดของแบบฟอร์ม

รีเทิร์น

FormForm นี้สำหรับการทำเชน

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

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

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