किसी फ़ॉर्म में कॉन्टेंट जोड़ने या सेटिंग, मेटाडेटा या कॉन्टेंट अपडेट करने के लिए, batchUpdate() तरीके का इस्तेमाल करें. यह तरीका, बदलावों को एक बैच में ग्रुप करता है, ताकि अगर कोई अनुरोध पूरा न हो, तो अन्य (संभावित तौर पर निर्भर) बदलाव न लिखे जाएं.
batchUpdate() तरीका, रिस्पॉन्स का मुख्य हिस्सा दिखाता है. इसमें हर अनुरोध के लिए एक रिस्पॉन्स होता है. हर रिस्पॉन्स, उससे जुड़े अनुरोध के इंडेक्स पर ही दिखता है. जिन अनुरोधों के लिए कोई रिस्पॉन्स लागू नहीं होता उनके इंडेक्स पर कोई रिस्पॉन्स नहीं दिखता.
शुरू करने से पहले
इस पेज पर दिए गए टास्क पूरे करने से पहले, ये टास्क पूरे करें:
- अर्ली अडॉप्टर प्रोग्राम के निर्देशों के मुताबिक, अनुमति/पुष्टि और क्रेडेंशियल सेटअप पूरा करें.
मेटाडेटा, सेटिंग या आइटम अपडेट करना
यहां दिए गए उदाहरण में, किसी फ़ॉर्म का मेटाडेटा अपडेट करने का तरीका बताया गया है. हालांकि, कॉन्टेंट और सेटिंग के लिए भी यही स्ट्रक्चर इस्तेमाल किया जाता है. इनमें updateFormInfo के बजाय, updateItem या updateSettings अनुरोधों का इस्तेमाल किया जाता है. हर अनुरोध के लिए, आपको बदले जाने वाले फ़ील्ड का नाम और अपडेट की गई वैल्यू देनी होगी. साथ ही, 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 सब-अनुरोध हैं. सब-अनुरोध A में location.index 0 है और सब-अनुरोध B में location.index 1 है. अगर requests कलेक्शन [A, B] है, तो batchUpdate पूरा हो जाएगा. अगर कलेक्शन [B, A] है, तो batchUpdate पूरा नहीं होगा. ऐसा इसलिए, क्योंकि location.index 1 तब तक मान्य नहीं है, जब तक फ़ॉर्म में इंडेक्स 0 पर कोई आइटम न हो.