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