স্প্রেডশিটে একাধিক শিট থাকতে পারে, প্রতিটি শিটে যেকোনো সংখ্যক সারি বা কলাম থাকতে পারে। একটি ঘর হল একটি নির্দিষ্ট সারি এবং কলামের ছেদস্থলে অবস্থিত একটি অবস্থান এবং এতে একটি ডেটা মান থাকতে পারে। Google Sheets API মানগুলি পড়া এবং লেখা সক্ষম করার জন্য spreadsheets.values রিসোর্স প্রদান করে।
এই পৃষ্ঠাটি spreadsheets.values রিসোর্স ব্যবহারের মূল বিষয়গুলি বর্ণনা করে। যদি আপনার কোনও শীটে সারি সন্নিবেশ করানো বা ফর্ম্যাটিং এবং অন্যান্য বৈশিষ্ট্য আপডেট করার প্রয়োজন হয়, তাহলে আপনাকে Update spreadsheets এ বর্ণিত spreadsheets.batchUpdate পদ্ধতিটি ব্যবহার করতে হবে।
পদ্ধতি
spreadsheets.values রিসোর্সটি একটি নির্দিষ্ট কাজের জন্য মান পড়ার এবং লেখার জন্য নিম্নলিখিত পদ্ধতিগুলি প্রদান করে:
| রেঞ্জ অ্যাক্সেস | পড়া | লেখা |
|---|---|---|
| একক পরিসর | spreadsheets.values.get | spreadsheets.values.update |
| একাধিক ব্যাপ্তি | spreadsheets.values.batchGet | spreadsheets.values.batchUpdate |
| সংযোজন | spreadsheets.values.append |
সাধারণভাবে, batchGet এবং batchUpdate পদ্ধতির সাথে (যথাক্রমে) একাধিক পঠন বা আপডেট একত্রিত করা একটি ভাল ধারণা, কারণ এটি দক্ষতা উন্নত করে।
আপনি বেসিক রিডিং এবং বেসিক লেখার নমুনা পৃষ্ঠাগুলিতে এই প্রতিটি পদ্ধতির উদাহরণ খুঁজে পেতে পারেন। সমস্ত নমুনা দেখতে, নমুনা ওভারভিউ পৃষ্ঠাটি দেখুন।
পড়ুন
একটি শীট থেকে ডেটা মান পড়ার জন্য, আপনার স্প্রেডশিট আইডি এবং পরিসরের জন্য A1 নোটেশন প্রয়োজন। শীট আইডি ( A1:B2 ) ছাড়া রেঞ্জ নির্দিষ্ট করার অর্থ হল অনুরোধটি স্প্রেডশিটের প্রথম শীটে কার্যকর হবে। স্প্রেডশিট আইডি এবং A1 নোটেশন সম্পর্কে আরও তথ্যের জন্য, Google Sheets API ওভারভিউ দেখুন।
বেশ কিছু ঐচ্ছিক কোয়েরি প্যারামিটার আউটপুটের ফর্ম্যাট নিয়ন্ত্রণ করে:
| বিন্যাস পরামিতি | ডিফল্ট মান |
|---|---|
majorDimension | সারি |
valueRenderOption | ফর্ম্যাটেড_ভ্যালু |
dateTimeRenderOption | SERIAL_NUMBER টি |
মনে রাখবেন যে আপনার শুধুমাত্র dateTimeRenderOption ব্যবহার করা উচিত যদি valueRenderOption FORMATTED_VALUE না হয়।
কত ডেটা ফেরত দেওয়া হবে তার কোনও স্পষ্ট সীমা নেই। ত্রুটিগুলি কোনও ডেটা ফেরত দেয় না। খালি পিছনের সারি এবং কলামগুলি বাদ দেওয়া হয়েছে।
নিচে singular এবং batch get পদ্ধতি বর্ণনা করা হল। মৌলিক পঠন ক্রিয়াকলাপের নমুনার জন্য, মৌলিক পঠন দেখুন।
একটি একক পরিসর পড়ুন
একটি স্প্রেডশিট থেকে একটি একক পরিসরের মান পড়তে, একটি spreadsheets.values.get অনুরোধ ব্যবহার করুন:
অ্যাপস স্ক্রিপ্ট
জাভা
জাভাস্ক্রিপ্ট
নোড.জেএস
পিএইচপি
পাইথন
রুবি
এই অনুরোধের প্রতিক্রিয়া একটি ValueRange অবজেক্ট হিসেবে ফেরত পাঠানো হয়।
একাধিক রেঞ্জ পড়ুন
একটি স্প্রেডশিট থেকে একাধিক, বিচ্ছিন্ন পরিসরের মান পড়তে, একটি spreadsheets.values.batchGet অনুরোধ ব্যবহার করুন যা আপনাকে পুনরুদ্ধার করার জন্য বেশ কয়েকটি পরিসর নির্দিষ্ট করতে দেয়:
অ্যাপস স্ক্রিপ্ট
জাভা
জাভাস্ক্রিপ্ট
নোড.জেএস
পিএইচপি
পাইথন
রুবি
এই অনুরোধের প্রতিক্রিয়াটি একটি BatchGetValuesResponse অবজেক্ট হিসাবে ফেরত পাঠানো হয় যাতে spreadsheetId এবং ValueRange অবজেক্টের একটি তালিকা থাকে।
লিখুন
একটি শীটে লেখার জন্য, আপনার স্প্রেডশিট আইডি, A1 নোটেশনে থাকা কোষের পরিসর এবং একটি উপযুক্ত অনুরোধ বডি অবজেক্টের মধ্যে আপনি যে ডেটা লিখতে চান তা প্রয়োজন। স্প্রেডশিট আইডি এবং A1 নোটেশন সম্পর্কে আরও তথ্যের জন্য, Google Sheets API ওভারভিউ দেখুন।
আপডেটের জন্য একটি বৈধ ValueInputOption প্যারামিটার প্রয়োজন। একক আপডেটের জন্য, এটি একটি প্রয়োজনীয় কোয়েরি প্যারামিটার। ব্যাচ আপডেটের জন্য, এই প্যারামিটারটি অনুরোধের বডিতে প্রয়োজন। ValueInputOption নিয়ন্ত্রণ করে কিভাবে ইনপুট ডেটা ব্যাখ্যা করা উচিত এবং ইনপুট স্ট্রিংগুলি পার্স করা হবে কিনা, যেমনটি নিম্নলিখিত টেবিলে বর্ণিত হয়েছে:
ValueInputOption | বিবরণ |
|---|---|
RAW | ইনপুটটি পার্স করা হয় না এবং একটি স্ট্রিং হিসেবে ঢোকানো হয়। উদাহরণস্বরূপ, ইনপুট "=1+2" কোষে সূত্র নয়, স্ট্রিংটিকে "=1+2" রাখে। (বুলিয়ান বা সংখ্যার মতো নন-স্ট্রিং মানগুলি সর্বদা RAW হিসেবে পরিচালিত হয়।) |
USER_ENTERED | ইনপুটটি ঠিক এমনভাবে পার্স করা হয় যেন এটি শীট UI-তে প্রবেশ করানো হয়েছে। উদাহরণস্বরূপ, "মার্চ 1 2016" একটি তারিখ হয়ে যায় এবং "=1+2" একটি সূত্র হয়ে যায়। ফর্ম্যাটগুলিও অনুমান করা যেতে পারে, তাই "$100.15" মুদ্রা ফর্ম্যাটিংয়ের সাথে একটি সংখ্যা হয়ে যায়। |
সিঙ্গুলার এবং ব্যাচ আপডেট পদ্ধতিগুলি নীচে বর্ণনা করা হয়েছে। মৌলিক লেখার ক্রিয়াকলাপের নমুনার জন্য, মৌলিক লেখা দেখুন।
একটি একক পরিসরে লিখুন
একটি একক পরিসরে ডেটা লেখার জন্য, একটি spreadsheets.values.update অনুরোধ ব্যবহার করুন:
অ্যাপস স্ক্রিপ্ট
জাভা
জাভাস্ক্রিপ্ট
নোড.জেএস
পিএইচপি
পাইথন
রুবি
আপডেট অনুরোধের মূল অংশটি অবশ্যই একটি ValueRange অবজেক্ট হতে হবে, যদিও শুধুমাত্র প্রয়োজনীয় ক্ষেত্র হল values । যদি range নির্দিষ্ট করা থাকে, তাহলে এটি URL-এর পরিসরের সাথে মিলবে। ValueRange এ, আপনি ঐচ্ছিকভাবে এর majorDimension নির্দিষ্ট করতে পারেন। ডিফল্টরূপে, ROWS ব্যবহার করা হয়। যদি COLUMNS নির্দিষ্ট করা থাকে, তাহলে প্রতিটি অভ্যন্তরীণ অ্যারে একটি সারির পরিবর্তে একটি কলামে লেখা হয়।
আপডেট করার সময়, কোনও ডেটা ছাড়াই মানগুলি এড়িয়ে যায়। ডেটা সাফ করতে, একটি খালি স্ট্রিং ("") ব্যবহার করুন।
একাধিক রেঞ্জ লিখুন
যদি আপনি একাধিক বিচ্ছিন্ন রেঞ্জ লিখতে চান, তাহলে আপনি একটি spreadsheets.values.batchUpdate অনুরোধ ব্যবহার করতে পারেন:
অ্যাপস স্ক্রিপ্ট
জাভা
জাভাস্ক্রিপ্ট
নোড.জেএস
পিএইচপি
পাইথন
রুবি
ব্যাচ আপডেট অনুরোধের মূল অংশটি অবশ্যই একটি BatchUpdateValuesRequest অবজেক্ট হতে হবে, যাতে একটি ValueInputOption এবং ValueRange অবজেক্টের একটি তালিকা থাকবে (প্রতিটি লিখিত পরিসরের জন্য একটি)। প্রতিটি ValueRange অবজেক্ট তার নিজস্ব range , majorDimension এবং ইনপুট ডেটা নির্দিষ্ট করে।
মান যোগ করুন
একটি শিটে ডেটা টেবিলের পরে ডেটা যুক্ত করতে, একটি spreadsheets.values.append অনুরোধ ব্যবহার করুন:
অ্যাপস স্ক্রিপ্ট
জাভা
জাভাস্ক্রিপ্ট
নোড.জেএস
পিএইচপি
পাইথন
রুবি
আপডেট অনুরোধের মূল অংশটি অবশ্যই একটি ValueRange অবজেক্ট হতে হবে, যদিও শুধুমাত্র প্রয়োজনীয় ক্ষেত্র হল values । যদি range নির্দিষ্ট করা থাকে, তাহলে এটি URL-এর পরিসরের সাথে মিলবে। ValueRange এ, আপনি ঐচ্ছিকভাবে এর majorDimension নির্দিষ্ট করতে পারেন। ডিফল্টরূপে, ROWS ব্যবহার করা হয়। যদি COLUMNS নির্দিষ্ট করা থাকে, তাহলে প্রতিটি অভ্যন্তরীণ অ্যারে একটি সারির পরিবর্তে একটি কলামে লেখা হয়।
ইনপুট রেঞ্জটি বিদ্যমান ডেটা অনুসন্ধান করতে এবং সেই রেঞ্জের মধ্যে একটি "টেবিল" খুঁজে পেতে ব্যবহৃত হয়। মানগুলি টেবিলের পরবর্তী সারিতে যুক্ত করা হয়, টেবিলের প্রথম কলাম থেকে শুরু করে। উদাহরণস্বরূপ, Sheet1 বিবেচনা করুন যা দেখতে এরকম:
| ক | খ | গ | দ | ই | |
| ১ | এক্স | y | z-এর | ||
| ২ | এক্স | y | z-এর | ||
| ৩ | |||||
| ৪ | এক্স | y | |||
| ৫ | y | z-এর | |||
| ৬ | এক্স | y | z-এর | ||
| ৭ |
শিটে দুটি টেবিল আছে: A1:C2 , এবং B4:D6 । নিম্নলিখিত সমস্ত range ইনপুটের জন্য সংযুক্ত মানগুলি B7 থেকে শুরু হবে:
-
Sheet1, কারণ এটি শীটের সমস্ত ডেটা পরীক্ষা করবে এবং নির্ধারণ করবে যেB4:D6এর টেবিলটি শেষ টেবিল। -
B4অথবাC5:D5, কারণ তারা উভয়ইB4:D6টেবিলে রয়েছে। -
B2:D4, কারণ পরিসরের শেষ টেবিলটি হলB4:D6টেবিল (যদিও এতেA1:C2টেবিলও রয়েছে)। -
A3:G10, কারণ পরিসরের শেষ টেবিলটি হলB4:D6টেবিল (যদিও এটি আগে থেকে শুরু হয়ে পরে শেষ হয়)।
নিম্নলিখিত range ইনপুটগুলি B7 এ লেখা শুরু করবে না:
-
A1A3থেকে লেখা শুরু করবে, কারণ এটিA1:C2টেবিলে রয়েছে। -
E4E4থেকে লেখা শুরু করবে, কারণ এটি কোনও টেবিলে নেই। (A4একই কারণেA4থেকেও লেখা শুরু করবে।)
অতিরিক্তভাবে, আপনি একটি টেবিলের পরে বিদ্যমান ডেটা ওভাররাইট করতে চান নাকি নতুন ডেটার জন্য নতুন সারি সন্নিবেশ করতে চান তা বেছে নিতে পারেন। ডিফল্টরূপে, ইনপুট টেবিলের পরে ডেটা ওভাররাইট করে। নতুন ডেটা নতুন সারিতে লিখতে, InsertDataOption ব্যবহার করুন এবং insertDataOption=INSERT_ROWS উল্লেখ করুন।
পত্রকগুলিতে ঘর এবং সারি সীমা সম্পর্কে আরও জানতে, Google ড্রাইভে আপনি যে ফাইলগুলি সংরক্ষণ করতে পারেন তা দেখুন।