หากต้องการเพิ่มเนื้อหาลงในแบบฟอร์มหรืออัปเดตการตั้งค่า ข้อมูลเมตา หรือเนื้อหา ให้ใช้เมธอด 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 รายการ คำขอย่อย A มี location.index เป็น 0 และคำขอย่อย B มี location.index เป็น 1 หากอาร์เรย์ requests คือ [A, B] คำขอ batchUpdate จะสำเร็จ แต่หากอาร์เรย์คือ [B, A] คำขอ batchUpdate จะล้มเหลว เนื่องจาก location.index 1 จะไม่ถูกต้องหากแบบฟอร์มยังไม่มีรายการที่ดัชนี 0