একটি স্প্রেডশিটে তার কোষে থাকা মান ডেটা ছাড়াও আরও অনেক ধরণের ডেটা থাকে, যেমন:
- মাত্রা
- কোষের বিন্যাস এবং সীমানা
- নামযুক্ত ব্যাপ্তি
- সুরক্ষিত পরিসর
- শর্তসাপেক্ষ বিন্যাস
এগুলি এমন কিছু ধরণের ডেটা যা স্প্রেডশিটের চেহারা এবং কার্যকারিতা নিয়ন্ত্রণ করে। spreadsheets.batchUpdate পদ্ধতি আপনাকে এই স্প্রেডশিটের যেকোনো বিবরণ আপডেট করতে দেয়। পরিবর্তনগুলিকে একটি ব্যাচে গোষ্ঠীভুক্ত করা হয় যাতে যদি একটি অনুরোধ ব্যর্থ হয়, তবে অন্য কোনও (সম্ভাব্যভাবে নির্ভরশীল) পরিবর্তন লেখা না হয়।
এই পৃষ্ঠাটি spreadsheets.batchUpdate পদ্ধতি ব্যবহারের মূল বিষয়গুলি বর্ণনা করে। যদি আপনার সেল মান ডেটা পড়তে এবং লিখতে হয়, তাহলে আপনি Read & write cell value এ বর্ণিত spreadsheets.values রিসোর্সটিও ব্যবহার করতে পারেন।
কার্যক্রমের বিভাগ
spreadsheets.batchUpdate দ্বারা সমর্থিত নির্দিষ্ট ক্রিয়াকলাপগুলিকে নিম্নলিখিত বিস্তৃত বিভাগে ভাগ করা যেতে পারে:
| বিভাগ | বিবরণ |
|---|---|
| যোগ করুন (এবং ডুপ্লিকেট করুন ) | নতুন অবজেক্ট যোগ করুন (কখনও কখনও পুরানো অবজেক্টের উপর ভিত্তি করে, যেমন ডুপ্লিকেট রিকোয়েস্টে)। |
| আপডেট (এবং সেট করুন ) | একটি বস্তুর নির্দিষ্ট বৈশিষ্ট্য আপডেট করুন, সাধারণত পুরানো বৈশিষ্ট্যগুলিকে একা রেখে দিন (যেখানে একটি সেট অনুরোধ পূর্ববর্তী ডেটা ওভাররাইট করে)। |
| মুছে ফেলুন | বস্তুগুলি সরান। |
নির্দিষ্ট ক্রিয়াকলাপের আচরণ বর্ণনা করার জন্য পরবর্তী বিভাগে এই বিভাগগুলি ব্যবহার করা হয়েছে।
ব্যাচ আপডেট অপারেশন
spreadsheets.batchUpdate পদ্ধতিটি এক বা একাধিক Request অবজেক্ট নিয়ে কাজ করে, প্রতিটি অবজেক্ট এক ধরণের অনুরোধ নির্দিষ্ট করে যা সম্পাদন করবে। অনেক ধরণের অনুরোধ রয়েছে। এখানে বিভিন্ন ধরণের অনুরোধের একটি তালিকা দেওয়া হল, যা বিভিন্ন বিভাগে ভাগ করা হয়েছে।
এছাড়াও কিছু অতিরিক্ত অনুরোধ রয়েছে যা ডেটা ম্যানিপুলেট করার জন্য ব্যবহারকারীর ক্রিয়াকলাপের অনুকরণ করে:
- অটোফিল রিকোয়েস্ট
- কাটপেস্টরিকোয়েস্ট
- কপিপেস্টরিকোয়েস্ট
- FindReplaceRequest সম্পর্কে
- ডেটার অনুরোধ আটকান
- TextToColumnsRequest সম্পর্কে
- সাজান রেঞ্জের অনুরোধ
সীমা
গুগল শিটে সেল এবং সারি সীমা সম্পর্কে আরও জানতে, গুগল ড্রাইভে আপনি যে ফাইলগুলি সংরক্ষণ করতে পারেন তা দেখুন।
মাঠের মুখোশ
অনেক "আপডেট" অনুরোধের জন্য ফিল্ড মাস্কের প্রয়োজন হয়। এগুলি কমা-বিভাজিত ক্ষেত্রগুলির একটি তালিকা যা একটি বস্তুর মধ্যে কেবলমাত্র নির্দিষ্ট ক্ষেত্রগুলি আপডেট করার জন্য এবং অন্যান্য ক্ষেত্রগুলিকে অপরিবর্তিত রাখার জন্য ব্যবহৃত হয়। * এর একটি ফিল্ড মাস্ককে একটি ওয়াইল্ডকার্ডের মতো বিবেচনা করা হয় এবং এটি একটি বার্তার প্রতিটি ক্ষেত্র নির্দিষ্ট করার জন্য সংক্ষিপ্ত বিবরণ (যার অর্থ হল যদি আপনি অনুরোধে কোনও ক্ষেত্রটির জন্য একটি মান নির্দিষ্ট না করেন তবে একটি ক্ষেত্র তার ডিফল্ট অবস্থায় ফিরে যেতে পারে)। ফিল্ড মাস্ক সম্পর্কে আরও তথ্যের জন্য, Use field masks দেখুন।
নিম্নলিখিত নমুনাটি শুধুমাত্র স্প্রেডশিটের শিরোনাম আপডেট করার জন্য UpdateSpreadsheetPropertiesRequest ব্যবহার করে:
অনুরোধ:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
অনুরোধের মূল অংশ:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
স্প্রেডশিটের নতুন শিরোনাম দিয়ে TITLE প্রতিস্থাপন করুন।
প্রতিক্রিয়া
স্প্রেডশিট আপডেট করার সময়, কিছু ধরণের অনুরোধ প্রতিক্রিয়া জানাতে পারে। এগুলি একটি অ্যারেতে ফেরত পাঠানো হয়, প্রতিটি প্রতিক্রিয়া সংশ্লিষ্ট অনুরোধের মতো একই সূচী ধারণ করে। কিছু অনুরোধের প্রতিক্রিয়া থাকে না এবং সেগুলির জন্য প্রতিক্রিয়া খালি থাকে।
সাধারণত, "যোগ করুন" অনুরোধগুলিতে এমন প্রতিক্রিয়া থাকে যা যোগ করা বস্তুর আইডির মতো তথ্য প্রদান করে। সমর্থিত প্রতিক্রিয়াগুলির তালিকার জন্য, প্রতিক্রিয়া দেখুন।
উদাহরণ
নিম্নলিখিত কোড নমুনা এই ক্রিয়াগুলি সম্পাদন করে:
-
titleভেরিয়েবল ব্যবহার করে স্প্রেডশিটের শিরোনাম আপডেট করে। -
findএবংreplacementভেরিয়েবল ব্যবহার করে স্প্রেডশিটে সেল মান খুঁজে বের করে এবং প্রতিস্থাপন করে।