Google Sheets API ওভারভিউ

গুগল শীটস এপিআই হলো একটি RESTful ইন্টারফেস যা আপনাকে একটি স্প্রেডশীটের ডেটা পড়তে এবং পরিবর্তন করতে দেয়। শীটস এপিআই আপনাকে যা করতে দেয়:

  • স্প্রেডশিট তৈরি করুন
  • স্প্রেডশীট সেলের মান পড়ুন এবং লিখুন
  • স্প্রেডশীট ফরম্যাটিং আপডেট করুন
  • সংযুক্ত শীটগুলি পরিচালনা করুন

নিচে শীটস এপিআই-তে ব্যবহৃত কিছু সাধারণ পরিভাষার তালিকা দেওয়া হলো:

স্প্রেডশিট

গুগল শিটসের প্রধান অবজেক্ট। এতে একাধিক Sheets থাকতে পারে, যার প্রতিটির Cells কাঠামোগত তথ্য থাকে। spreadsheets রিসোর্সটি একটি স্প্রেডশিটকে প্রতিনিধিত্ব করে। এতে একটি অনন্য spreadsheetId ভ্যালু থাকে।

স্প্রেডশিট আইডি
একটি স্প্রেডশীটের অনন্য শনাক্তকারী। এটি অক্ষর, সংখ্যা এবং কিছু বিশেষ অক্ষর সম্বলিত একটি নির্দিষ্ট স্ট্রিং যা একটি স্প্রেডশীটকে নির্দেশ করে এবং এটি স্প্রেডশীটের URL থেকে পাওয়া যেতে পারে। স্প্রেডশীটের নাম পরিবর্তন হলেও স্প্রেডশীট আইডি অপরিবর্তিত থাকে।
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
শীট

একটি স্প্রেডশীটের ভেতরের একটি পৃষ্ঠা বা ট্যাব। Sheets রিসোর্সটি একটি শীটকে উপস্থাপন করে। SheetProperties অবজেক্টের অংশ হিসেবে এতে একটি অনন্য সাংখ্যিক sheetId মান এবং শীটের title থাকে।

শীট আইডি
একটি স্প্রেডশীটের মধ্যে থাকা কোনো নির্দিষ্ট শীটের অনন্য শনাক্তকারী। এটি একটি বিশেষ পূর্ণসংখ্যা যা একটি শীটকে নির্দেশ করে এবং এটি স্প্রেডশীটের URL থেকে পাওয়া যেতে পারে। শীটের নাম পরিবর্তন হলেও শীট আইডি অপরিবর্তিত থাকে। একটি উদাহরণের জন্য, স্প্রেডশীট আইডি দেখুন।
কোষ

একটি শীটের মধ্যে থাকা টেক্সট বা ডেটার একটি স্বতন্ত্র ক্ষেত্র। সেলগুলো সারি এবং কলামে সাজানো থাকে এবং এগুলোকে সেলের একটি রেঞ্জ হিসাবে গ্রুপ করা যায়। Cells রিসোর্সটি প্রতিটি সেলকে উপস্থাপন করে, কিন্তু এর কোনো অনন্য আইডি ভ্যালু নেই। এর পরিবর্তে, সারি এবং কলামের স্থানাঙ্ক সেলগুলোকে শনাক্ত করে।

A1 নোটেশন
একটি স্ট্রিং ব্যবহার করে কোনো সেল বা সেলের রেঞ্জ নির্ধারণ করার জন্য ব্যবহৃত সিনট্যাক্স, যেখানে শীটের নামের সাথে কলামের অক্ষর এবং সারির নম্বর ব্যবহার করে সেলের শুরু ও শেষের স্থানাঙ্ক থাকে। সেলের একটি অ্যাবসোলিউট রেঞ্জ উল্লেখ করার ক্ষেত্রে এই পদ্ধতিটি সবচেয়ে প্রচলিত এবং কার্যকর।
  • Sheet1!A1:B2 বলতে Sheet1-এর প্রথম দুটি সারি এবং কলামের সমস্ত সেলকে বোঝায়।
  • Sheet1!A:A বলতে Sheet1-এর প্রথম কলামের সমস্ত সেলকে বোঝায়।
  • Sheet1!1:2 বলতে Sheet1-এর প্রথম দুটি সারির সমস্ত সেলকে বোঝায়।
  • Sheet1!A5:A বলতে শীট ১-এর প্রথম কলামের ৫ নং সারি থেকে পরবর্তী সমস্ত সেলকে বোঝায়।
  • A1:B2 বলতে প্রথম দৃশ্যমান শীটের প্রথম দুটি সারি এবং কলামের সমস্ত সেলকে বোঝায়।
  • Sheet1 বলতে Sheet1-এর সমস্ত সেলকে বোঝায়।
  • 'Jon's_Data'!A1:D5 বলতে "Jon's_Data" নামের একটি শীটের প্রথম পাঁচটি সারি এবং চারটি কলামের সমস্ত সেলকে বোঝায়।
  • 'My Custom Sheet'!A:A বলতে "My Custom Sheet" নামের একটি শীটের প্রথম কলামের সমস্ত সেলকে বোঝায়।
  • 'My Custom Sheet' বলতে "আমার কাস্টম শীট"-এর সমস্ত সেলকে বোঝায়।

শীটের নামে স্পেস বা বিশেষ অক্ষর থাকলে একক উদ্ধৃতি চিহ্ন ব্যবহার করতে হবে।

পরামর্শ : যেখানে সম্ভব, আপনার স্প্রেডশীটে অবজেক্টগুলোর জন্য স্বতন্ত্র নাম ব্যবহার করুন। উদাহরণস্বরূপ, A1 (উদ্ধৃতি চিহ্ন ছাড়া) বলতে প্রথম দৃশ্যমান শীটের A1 সেলকে বোঝায়। 'A1' বলতে A1 নামের একটি শীটকে বোঝায়। একইভাবে, Sheet1 বলতে Sheet1 নামের একটি শীটকে বোঝায়। তবে, যদি "Sheet1" শিরোনামে একটি নেমড রেঞ্জ থাকে, তাহলে Sheet1 বলতে সেই নেমড রেঞ্জকে এবং 'Sheet1' বলতে শীটটিকে বোঝায়।

R1C1 নোটেশন
একটি স্ট্রিং ব্যবহার করে কোনো সেল বা সেলের রেঞ্জ নির্ধারণ করার জন্য ব্যবহৃত একটি সিনট্যাক্স, যেখানে শীটের নামের সাথে সারি এবং কলাম নম্বর ব্যবহার করে সেলের শুরু ও শেষের স্থানাঙ্ক থাকে। এই পদ্ধতিটি A1 নোটেশনের চেয়ে কম প্রচলিত, কিন্তু কোনো নির্দিষ্ট সেলের অবস্থানের সাপেক্ষে সেলের একটি রেঞ্জকে নির্দেশ করার ক্ষেত্রে এটি কার্যকর হতে পারে।
  • Sheet1!R1C1:R2C2 বলতে Sheet1-এর উপরের দুটি সারির প্রথম দুটি সেলকে বোঝায়।
  • R1C1:R2C2 বলতে প্রথম দৃশ্যমান শীটের উপরের দুটি সারির প্রথম দুটি সেলকে বোঝায়।
  • Sheet1!R[3]C[1] বলতে বর্তমান সেলের তিন সারি নিচে এবং এক কলাম ডানে অবস্থিত সেলকে বোঝায়।
নামযুক্ত পরিসর
অ্যাপ্লিকেশন জুড়ে রেফারেন্স সহজ করার জন্য একটি কাস্টম নামসহ সংজ্ঞায়িত সেল বা সেলের পরিসর। একটি FilterView রিসোর্স একটি নামযুক্ত পরিসরকে প্রতিনিধিত্ব করে।
সুরক্ষিত পরিসর
একটি সংজ্ঞায়িত সেল বা সেলসমূহের পরিসর যা পরিবর্তন করা যায় না। একটি ProtectedRange রিসোর্স একটি সুরক্ষিত পরিসরকে প্রতিনিধিত্ব করে।
  • Google Workspace API ব্যবহার করে ডেভেলপ করা, যার মধ্যে অথেনটিকেশন এবং অথরাইজেশন পরিচালনাও অন্তর্ভুক্ত, সে সম্পর্কে জানতে Develop on Google Workspace দেখুন।

  • কিভাবে একটি শীটস এপিআই অ্যাপ কনফিগার ও রান করতে হয় তা জানতে, জাভাস্ক্রিপ্ট কুইকস্টার্টটি দেখুন।