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