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