หากต้องการเพิ่มเนื้อหาลงในแบบฟอร์มหรืออัปเดตการตั้งค่า ข้อมูลเมตา หรือเนื้อหา ให้ใช้วิธีการ
batchUpdate()
ซึ่งจะจัดกลุ่มการเปลี่ยนแปลงไว้ด้วยกันในชุดเดียว เพื่อให้หากคำขอใดคำขอหนึ่ง
ล้มเหลว ระบบจะไม่เขียนการเปลี่ยนแปลงอื่นๆ (ที่อาจขึ้นอยู่กับคำขอดังกล่าว)
เมธอด batchUpdate()
จะแสดงผลเนื้อหาการตอบกลับ ซึ่งมีคำตอบ
สำหรับแต่ละคำขอ การตอบกลับแต่ละรายการจะใช้ดัชนีเดียวกันกับคำขอที่เกี่ยวข้อง สำหรับคำขอที่ไม่มีการตอบกลับที่เกี่ยวข้อง การตอบกลับที่ดัชนีนั้นจะว่างเปล่า
ก่อนเริ่มต้น
โปรดทํางานต่อไปนี้ก่อนดําเนินการต่อกับงานในหน้านี้
- ดำเนินการให้สิทธิ์/การตรวจสอบสิทธิ์และการตั้งค่าข้อมูลเข้าสู่ระบบให้เสร็จสมบูรณ์ในวิธีการของโปรแกรมผู้ใช้รุ่นแรก
อัปเดตข้อมูลเมตา การตั้งค่า หรือรายการ
ตัวอย่างต่อไปนี้แสดงวิธีอัปเดตข้อมูลเมตาของแบบฟอร์ม แต่โครงสร้าง
จะเหมือนกันสำหรับเนื้อหาและการตั้งค่า โดยจะใช้คำขอ updateItem
หรือ
updateSettings
แทน updateFormInfo
สำหรับแต่ละคำขอ คุณจะต้องระบุชื่อของฟิลด์ที่จะเปลี่ยนแปลงและค่าที่อัปเดต พร้อมกับค่า updateMask
เพื่อจำกัดการเปลี่ยนแปลงเฉพาะฟิลด์ที่คุณระบุ
REST
หากต้องการอัปเดตคำอธิบายของแบบฟอร์ม ให้เรียกใช้เมธอด
batchUpdate()
ด้วยรหัสแบบฟอร์มและค่าคำอธิบายที่อัปเดตแล้ว
ตัวอย่างเนื้อความของคำขอ
"requests": [{
"updateFormInfo": {
"info": {
"description": "Please complete this quiz based on this week's readings for class."
},
"updateMask": "description"
}
}]
Python
Node.js
เพิ่มรายการ
ตัวอย่างต่อไปนี้แสดงวิธีเพิ่มเนื้อหาใหม่ลงในแบบฟอร์ม เมื่อเพิ่มเนื้อหาใหม่ คุณต้องระบุตำแหน่งที่มีดัชนีซึ่งควรแทรกเนื้อหาใหม่ เช่น สถานที่ที่มีดัชนี 0
จะแทรกเนื้อหาที่
จุดเริ่มต้นของแบบฟอร์ม
REST
หากต้องการเพิ่มรายการลงในแบบฟอร์ม ให้เรียกใช้เมธอด
batchUpdate()
ด้วยรหัสแบบฟอร์ม ข้อมูลของรายการ และตำแหน่งที่ต้องการ
ตัวอย่างเนื้อความของคำขอ
"requests": [{
"createItem": {
"item": {
"title": "Homework video",
"description": "Quizzes in Google Forms",
"videoItem": {
"video": {
"youtubeUri": "https://www.youtube.com/watch?v=Lt5HqPvM-eI"
}
}},
"location": {
"index": 0
}
}]
Python
Node.js
ขอคำสั่ง
เมธอด batchUpdate()
รับอาร์เรย์ของคำขอย่อย เช่น createItem
และ updateItem
ระบบจะตรวจสอบคำขอรองทีละรายการตามลำดับที่ระบุ
ตัวอย่าง: คำขอ batchUpdate
มีอาร์เรย์ requests
ที่มีคำขอ createItem
ย่อย 2 รายการ คำขอย่อย ก มี location.index
0 และคำขอย่อย ข มี location.index
1 หากrequests
อาร์เรย์คือ [A, B] batchUpdate
จะ
สำเร็จ หากอาร์เรย์เป็น [B, A] batchUpdate
จะล้มเหลว เนื่องจาก location.index
1 ไม่ถูกต้อง เว้นแต่แบบฟอร์มจะมีรายการที่ดัชนี 0 อยู่แล้ว