หากต้องการเพิ่มเนื้อหาลงในแบบฟอร์มหรืออัปเดตการตั้งค่า ข้อมูลเมตา หรือเนื้อหา ให้ใช้วิธีการ
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 อยู่แล้ว