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