কোনো ফর্মে কন্টেন্ট যোগ করতে বা সেটিংস, মেটাডেটা বা কন্টেন্ট আপডেট করতে batchUpdate() মেথডটি ব্যবহার করুন, যা পরিবর্তনগুলোকে একসাথে একটি ব্যাচে একত্রিত করে, ফলে যদি একটি রিকোয়েস্ট ব্যর্থ হয়, তবে অন্য কোনো (সম্ভাব্য নির্ভরশীল) পরিবর্তন লেখা হয় না।
batchUpdate() মেথডটি একটি রেসপন্স বডি রিটার্ন করে, যার মধ্যে প্রতিটি রিকোয়েস্টের জন্য একটি করে রেসপন্স থাকে। প্রতিটি রেসপন্স সংশ্লিষ্ট রিকোয়েস্টের ইন্ডেক্সেই অবস্থান করে; যেসব রিকোয়েস্টের কোনো প্রযোজ্য রেসপন্স নেই, সেগুলোর ক্ষেত্রে সেই ইন্ডেক্সের রেসপন্সটি খালি থাকবে।
শুরু করার আগে
এই পৃষ্ঠার কাজগুলো শুরু করার আগে নিম্নলিখিত কাজগুলো সম্পন্ন করুন:
- আর্লি অ্যাডাপ্টার প্রোগ্রামের নির্দেশাবলীতে অনুমোদন/প্রমাণীকরণ এবং ক্রেডেনশিয়াল সেটআপ সম্পূর্ণ করুন।
মেটাডেটা, সেটিংস বা আইটেম আপডেট করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি ফর্মের মেটাডেটা আপডেট করতে হয়, কিন্তু কন্টেন্ট এবং সেটিংসের জন্য কাঠামোটি একই—এগুলো updateFormInfo এর পরিবর্তে updateItem বা updateSettings রিকোয়েস্ট ব্যবহার করে। প্রতিটি রিকোয়েস্টের জন্য, আপনাকে যে ফিল্ডটি পরিবর্তন করতে হবে তার নাম এবং আপডেট করা মান সরবরাহ করতে হবে, সাথে একটি updateMask ভ্যালুও দিতে হবে যা আপনার নির্দিষ্ট করা ফিল্ডগুলিতে পরিবর্তন সীমাবদ্ধ রাখে।
বিশ্রাম
ফর্মের বিবরণ আপডেট করতে, ফর্ম আইডি এবং আপডেট করা বিবরণের মান সহ batchUpdate() মেথডটি কল করুন।
নমুনা অনুরোধের মূল অংশ
"requests": [{
"updateFormInfo": {
"info": {
"description": "Please complete this quiz based on this week's readings for class."
},
"updateMask": "description"
}
}]
পাইথন
নোড.জেএস
একটি আইটেম যোগ করুন
নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি ফর্মে নতুন কন্টেন্ট যোগ করতে হয়। নতুন কন্টেন্ট যোগ করার সময়, আপনাকে অবশ্যই একটি ইনডেক্স সহ একটি লোকেশন প্রদান করতে হবে যেখানে নতুন কন্টেন্টটি যুক্ত হবে। উদাহরণস্বরূপ, ইনডেক্স 0 সহ একটি লোকেশন ফর্মের শুরুতে কন্টেন্টটি যুক্ত করবে।
বিশ্রাম
ফর্মে কোনো আইটেম যোগ করতে, ফর্ম আইডি, আইটেমের তথ্য এবং নির্বাচিত অবস্থান সহ 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
}
}]
পাইথন
নোড.জেএস
অর্ডার অনুরোধ করুন
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-তে আগে থেকেই কোনো আইটেম থাকে।